Data Sheet

Teledyne LeCroy Automation API Reference Manual for USBTracer, USB Advisor, and Voyager USB Protocol

Suite

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.