pipx40_init

 

VB

Function

pipx40_init (ByVal rsrcName As String, ByVal id_query As Boolean, ByVal reset_instr As Boolean, ByRef vi As Long) As Long

C++

ViStatus

pipx40_init (ViRsrc rsrcName, ViBoolean id_query, ViBoolean reset_instr, ViPSession vi);

 

Parameter

I/O

Description

rsrcName

in

Instrument description (resource name)

id_query

in

if VI_TRUE then perform in-system verification; if VI_FALSE then do not perform in-system verification. See note below.

reset_instr

in

if VI_TRUE then perform reset operation; if VI_FALSE then do not perform reset operation. See note below.

vi

out

Instrument handle

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

This function establishes communications with the instrument.

Remarks

The values of the id_query and reset_instr parameters are ignored: instrument identity is always checked, and the instrument is always reset when it is opened. No error is given if these options are not specified in the function call.

 

If the initialisation function encounters an error, an error code return value will be sent, any valid sessions obtained by pipx40_init will be closed and the output parameter vi is set to zero (VI_NULL).