pipx40_getSubType

 

VB

Function

pipx40_getSubType (ByVal vi As Long, ByVal subUnit As Long, ByVal out As Boolean, ByVal subType As String) As Long

C++

ViStatus

pipx40_getSubType (ViSession vi, ViUInt32 subUnit, ViBoolean out, ViString type);

 

Parameter

I/O

Description

vi

in

Instrument handle

subUnit

in

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

out

in

sub-unit function: 0 for INPUT, 1 for OUTPUT

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 a sub-unit, as a text string.

subType string

Description

INPUT(<size>)

Digital inputs

SWITCH(<size>)

Uncommitted switches

MUX(<size>)

Multiplexer, single-channel only

MUXM(<size>)

Multiplexer, multi-channel

MATRIX(<columns>X<rows>)

Matrix, LF

MATRIXR(<columns>X<rows>)

Matrix, RF

DIGITAL(<size>)

Digital outputs

RES(<size>)

Programmable resistor

ATTEN(<number of pads>)

Programmable RF attenuator

PSUDC(0)

Power supply, DC

 

Note that for some types additional information is obtainable using alternate functions:

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).