Teledyne LeCroy USB Analyzer Automation Manual - Manual (Page 21)

Teledyne LeCroy Automation API Reference Manual for USBTracer, USB Advisor, and Voyager USB Protocol
Suite
21
2.1.11 IUsbAnalyzer::StopRecordingAndWaitForTrace
HRESULT StopRecordingAndWaitForTrace
( [out, retval] IDispatch** trace );
Stops recording started by the StartRecording method and returns the pointer to the trace object
created.
Parameters
trace Address of a pointer to the UsbTrace object primary interface
Return values
ANALYZERCOMERROR_UNABLESTOPRECORDING Error when stopping recording
ANALYZERCOMERROR_WRONGCALL
Error when trying to access
trace when it is being destroyed.
Remarks
This method stops recording started by the StartRecording method and does not return until the
recording is uploaded and a trace object related to this recording is created. In contrast, for
StopRecording, no event is issued when recording is stopped by this method.
In rare cases, the method may return ANALYZERCOMERROR_WRONGCALL
error. This may happen when
recording stopped by itself (for example, because buffer is full), and the method call occurs when the
recorded trace is being released and destroyed. Subsequent method calls will reopen the recorded
trace. To avoid this issue, use a recording-buffer size that is big enough, so that the method call will
occur when recording is still in progress and recording buffer is not full.