viGpibPassControl
Purpose
Tell the GPIB device at the specified address to become controller in charge (CIC).
C Syntax
ViStatus viGpibPassControl(ViSession vi, ViUInt16 primAddr, ViUInt16 secAddr)
Visual Basic Syntax
viGPIBPassControl& (ByVal vi&, ByVal primAddr%, ByValsec Addr%)
Resource Classes
GPIB INTFC
Parameters
| Name | Direction | Description |
|---|---|---|
|
vi |
IN |
Unique logical identifier to a session. |
|
primAddr |
IN |
Primary address of the GPIB device to which you want to pass control. |
|
secAddr |
IN |
Secondary address of the targeted GPIB device. If the targeted device does not have a secondary address, this parameter should contain the value VI_NO_SEC_ADDR. |
Return Values
| Completion Codes | Description |
|---|---|
|
VI_SUCCESS |
Operation completed successfully. |
| Error Codes | Description |
|---|---|
|
VI_ERROR_INV_OBJECT |
The given session reference is invalid. |
|
VI_ERROR_NSUP_OPER |
The given vi does not support this operation. |
|
VI_ERROR_RSRC_LOCKED |
Specified operation could not be performed because the resource identified by vi has been locked for this kind of access. |
|
VI_ERROR_TMO |
Timeout expired before operation completed. |
|
VI_ERROR_NCIC |
The interface associated with the given vi is not currently the controller in charge. |
|
VI_ERROR_NLISTENERS |
No Listeners condition is detected (both NRFD and NDAC are deasserted). |
|
VI_ERROR_IO |
An unknown I/O error occurred during transfer. |
|
VI_ERROR_INV_PARAMETER |
The primary or secondary address is invalid. |
Description
This operation passes controller in charge status to the device indicated by primAddr and secAddr, and then deasserts the ATN line. This operation assumes that the targeted device has controller capability. This operation is valid only on GPIB INTFC (interface) sessions.
Related Topics