beautypg.com

10 ianalyzer::createrecordingsnapshot, Ianalyzer::createrecordingsnapshot, Catc ver. 1.40 – Teledyne LeCroy Automation API for Bluetooth Analyzers User Manual

Page 26

background image

20

Automation API for CATC Bluetooth Analyzers

CATC

Ver. 1.40

2.3.10 IAnalyzer::CreateRecordingSnapshot

Causes the analyzer to create a temporary trace file without stopping the recording.

Parameters

None.

Return values

ANALYZERCOMERROR_UNABLEOPENFILE - Unable to create the snapshot trace
file.

Remarks

The snapshot trace file includes all the recorded Bluetooth traffic from the beginning of
the recording or from the previous call of this command to the present calls.
Each snapshots trace would be stored in a different file with the name
"$$$snapshot_[index].blt", where [index] is a running numbering starting from 0. The
snapshot traces are displayed in different windows and they are deleted at the end of a
recording unless saved with a different name or path.

Example

C++:

IBTAnalyzer* bt_analyzer;

. . .

HRESULT CreateRecordingSnapshot();

try

{

bt_analyzer->CreateRecordingSnapshot();

}

catch ( _com_error& er)

{

if (er.Description().length() > 0)

::MessageBox( NULL, er.Description(), _T("BTAnalyzer client"),

MB_OK );

else

::MessageBox( NULL, er.ErrorMessage(), _T("BTAnalyzer client"),

MB_OK );

return 1;

}

HRESULT CreateRecordingSnapshot ( )