niDCPower_init
ViStatus niDCPower_init (ViRsrc resourceName, ViBoolean IDQuery, ViBoolean resetDevice, ViSession vi);
Purpose
Creates a new IVI instrument driver session to the device specified in resourceName and returns a session handle you use to identify the device in all subsequent NI-DCPower function calls. This function also sends initialization commands to set the device to the state necessary for the operation of NI-DCPower.
To place the device in a known start-up state when creating a new session, set resetDevice to VI_TRUE. This action is equivalent to using the niDCPower_reset function.
To open a session and leave the device in its existing configuration without passing through a transitional output state, set resetDevice to VI_FALSE, and immediately call the niDCPower_Abort function. To apply a new configuration without disrupting the output channels of the device, configure the device in Delayed Configuration mode as in the previous session changing only the desired settings, and then call niDCPower_Initiate function.
Parameters
| Input | ||||||
| Name | Type | Description | ||||
| resourceName | ViRsrc | Specifies the resourceName assigned by Measurement & Automation Explorer (MAX), for example "PXI1Slot3" where "PXI1Slot3" is an instrument's resourceName. resourceName can also be a logical IVI name. | ||||
| IDQuery | ViBoolean | Specifies whether the device is queried to determine if the device is a valid instrument for NI-DCPower. Defined Values:
Default Value: VI_TRUE |
||||
| resetDevice | ViBoolean | Specifies whether to reset the device during the initialization procedure. Defined Values:
Default Value: VI_TRUE |
||||
| Output | ||||||
| Name | Type | Description | ||||
| vi | ViSession | Returns a session handle that you use to identify the session in all subsequent NI-DCPower function calls. | ||||
Return Value
| Name | Type | Description |
| Status | ViStatus | Reports the status of this operation. To obtain a text description of the status code, call the niDCPower_error_message function. To obtain additional information concerning the error condition, call the niDCPower_GetError function. |