Teledyne LeCroy USB Analyzer Automation Manual User Manual

Page 119

background image

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

119


HRESULT OnStatusReport (

[in] short subsystem,
[in] short state,
[in] long percent_done );

Fires when there is a change in Analyzer state or there is a change in progress (percent_done) of the
Analyzer state.

Parameters

subsystem

Subsystem sending event has the following values:

RECORDING_PROGRESS_REPORT

( 1 ) –

recording subsystem


state

Current Analyzer state;

has the following values:


If subsystem is RECORDING_PROGRESS_REPORT

:

ANALYZERSTATE_IDLE (-1 ) Idle

ANALYZERSTATE_WAITING_TRIGGER ( 0 ) Recording in progress,

Analyzer is waiting for trigger

ANALYZERSTATE_RECORDING_TRIGGERED ( 1 ) Recording in progress,

Analyzer triggered

ANALYZERSTATE_UPLOADING_DATA ( 2 ) Uploading in progress

ANALYZERSTATE_SAVING_DATA ( 3 ) Saving data in progress


percent_done

Shows the progress of currently performing operation,
(valid only if subsystem is RECORDING_PROGRESS_REPORT)

:

When Analyzer state is

ANALYZERSTATE_IDLE, this parameter is not

applicable,

When Analyzer state is

ANALYZERSTATE_WAITING_TRIGGER or

ANALYZERSTATE_RECORDING_TRIGGERED, this
parameter shows Analyzer memory utilization.

When Analyzer state is

ANALYZERSTATE_UPLOADING_DATA, this parameter

shows the percent of data uploaded.

When Analyzer state is

ANALYZERSTATE_SAVING_DATA,

this parameter

shows the percent of data saved.

Return values


Remarks


Make sure the event handlers have

__stdcall

calling convention.