viGpibPassControl
Syntax
viGpibPassControl(ViSession vi, ViUInt16 primAddr, ViUInt16 secAddr);
Description
Tells the GPIB device at the specified address to become controller in charge (CIC). 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.
Parameters
|
Name |
Dir |
Type |
Description |
|---|---|---|---|
|
vi |
IN |
ViSession |
Unique logical identifier to a session. |
|
primAddr |
IN |
ViUInt16 |
Primary address of the GPIB device to which you want to pass control. |
|
secAddr |
IN |
ViUInt16 |
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
|
Type ViStatus |
This is the function return status. It returns either a completion code or an error code as follows. |
|
Completion Code |
Description |
|---|---|
|
VI_SUCCESS |
Operation completed successfully. |
|
Error Code |
Description |
|
VI_ERROR_INV_SESSION |
The given session or object reference is invalid (both are the same value). |
|
VI_ERROR_IO |
An unknown I/O error occurred during transfer. |
|
VI_ERROR_NCIC |
The interface associated with this session is not currently the controller in charge. |
|
VI_ERROR_NLISTENERS |
No listeners condition is detected (both NRFD and NDAC are deasserted). |
|
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. |
See Also
INTFC resource description