beautypg.com

6 ifcanalyzer::loaddisplayoptions – Teledyne LeCroy SierraFC Automation API User Manual

Page 17

background image

LeCroy Corporation

SierraFC M8-4 API Reference Manual

Manual Version 1.00

17

3.1.6 IFCAnalyzer::LoadDisplayOptions


HRESULT LoadDisplayOptions (

[in] BSTR do_file_name
[in] short do_layers );

Loads display options that will apply to a trace opened or recorded later.

Parameters


do_file_name

String providing the full pathname to display options file

do_layers

Specifies the mask layer of packet view, which can be a

combination of these values:
LAYER_LINK

= 0x1

LAYER_SEQUENCE

= 0x2

LAYER_SCSI_COMMAND

= 0x4

LAYER_LS_COMMAND

= 0x8

LAYER_SW_COMMAND

= 0x10

LAYER_GS_COMMAND

= 0x20

Return values

ANALYZERCOMERROR_UNABLELOADDO

- unable to load the display options file

Remarks

Use this method if you want to filter traffic of some type. The display options loaded by
this method call apply only on trace files opened or recorded after this call.

The display options file is the file with extension .opt created by the SierraFC Protocol
Analyzer application. You can create this

file when you select ―Setup –> Display

Options…‖ from the SierraFC M8-4 SierraFC M164 application menu, change the
display options in the

―Display Options‖ dialog, and select the ―Save…‖ button.


Example


See

ITrace::ApplyDisplayOptions

.