pipx40_attenGetType

VB

Function

pipx40_attenGetType (ByVal vi As Long, ByVal subUnit As Long, ByVal subType As String) As Long

C++

ViStatus

pipx40_attenGetType (ViSession vi, ViUInt32 subUnit, ViString subType);

 

Parameter

I/O

Description

vi

in

Instrument handle

subUnit

in

Numeric variable indicating the sub-unit for which information is to be obtained

subType

out

Character string to receive the result

Return Value

0 = Successful operation. Negative values are error codes and positive values are warnings. To get a description of the error, pass the error code to pipx40_error_message.

Description

Obtains a type description of an attenuator sub-unit, as a text string.

subType string

Description

ATTEN(<number of steps>,<step size in dB>)

Programmable RF attenuator

Visual Basic Note

The result is a C-style string, terminated by an ASCII null character. It can be converted to a Visual Basic string by counting the number of characters upto but excluding the terminating null, then performing:

VBstring = LEFT$(subType, character_count).

Remarks

The description obtained by this function is a logical one; a physical description indicating the number of discrete pads in the attenuator can be obtained using pipx40_getSubType.