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

Teledyne LeCroy Automation API Reference Manual for USBTracer, USB Advisor, and Voyager USB Protocol
Suite
20
2.1.10 IAnalyzer::GetRecordingOptions
HRESULT GetRecordingOptions (
[out, retval] IDispatch** recording_options );
Retrieves the primary interface for access to recording options.
Parameters
recording_options Address of a pointer to the UsbRecOptions object
primary interface
Return values
Remarks
UsbRecOptions object is created via this method call, if call was successful.
Example
WSH:
Set Analyzer = WScript.CreateObject("CATC.USBTracer")
Set RecOptions = Analyzer.GetRecordingOptions
C++:
HRESULT hr;
IUsbAnalyzer* poUsbAnalyzer;
// Create UsbAnalyzer object.
if ( FAILED( CoCreateInstance(
CLSID_UsbAdvisor,
NULL, CLSCTX_SERVER,
IID_IUsbAnalyzer,
(LPVOID *)&poUsbAnalyzer ) )
return;
// Open trace file.
IDispatch* rec_opt;
try
{
rec_opt = poUsbAnalyzer->GetRecordingOptions();
}
catch (_com_error& er)
{
if (er.Description().length() > 0)
::MessageBox( NULL, er.Description(), _T("UsbAnalyzer client"), MB_OK );
else
::MessageBox( NULL, er.ErrorMessage(), _T("UsbAnalyzer client"), MB_OK );
return 1;
}
// Query for VTBL interface.
IUsbRecOptions* ib_rec_opt;
hr = rec_opt->QueryInterface( IID_IUsbRecOptions, (LPVOID *)&ib_rec_opt );
rec_opt->Release();
if( FAILED(hr) )
return;