pipx40_getSubInfo

 

VB

Function

pipx40_getSubInfo (ByVal vi As Long, ByVal subUnit As Long, ByVal out As Boolean, ByRef subType As Long, ByRef rows As Long, ByRef columns As Long) As Long

C++

ViStatus

pipx40_getSubInfo (ViSession vi, ViUInt32 subUnit, ViBoolean out, ViPUInt32 subType, ViPUInt32 rows, ViPUInt32 columns);

 

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

pointer to variable to receive type code

rows

out

pointer to variable to receive row count

columns

out

pointer to variable to receive column count

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 numeric values.

Remarks

Row and column values give the dimensions of the sub-unit. For all types other than matrices the column value contains the significant dimension: their row value is always 1.

 

Input sub-units are always indicated with a type code of 1.

 

Output sub-unit type codes are:

Driver constant

subType

value

Description

pipx40_TYPE_SW

1

Uncommitted switches

pipx40_TYPE_MUX

2

Multiplexer, single-channel only

pipx40_TYPE_MUXM

3

Multiplexer, multi-channel

pipx40_TYPE_MAT

4

Matrix, LF

pipx40_TYPE_MATR

5

Matrix, RF

pipx40_TYPE_DIG

6

Digital outputs

pipx40_TYPE_RES

7

Programmable resistor

pipx40_TYPE_ATTEN

8

Programmable RF attenuator

pipx40_TYPE_PSUDC

9

Power supply, DC

 

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