Agilent 4155C/4156C VXIplug&play Driver User’s Guide, Edition 4 2-63
Driver Function Reference
hpe5250a_dcl
couplestate_cardno Card number. 1 (card 1), 2 (card 2), 3 (card 3), 4 (card 4), or 5
(all card) in the normal configuration mode, or 0 (all card in the
automatic configuration mode). For the configuration mode, see
hpe5250a_func.
couple_state Couple port mode. 0 (off) or 1 (on).
hpe5250a_dcl
This function sends a device clear (DCL) to the instrument.
A device clear will abort the present operation and enable the instrument to accept a
new command or query.
This is particularly useful in situations where it is not possible to determine the
instrument state. In this case, it is customary to send a device clear before issuing a
new instrument driver function. The device clear ensures that the instrument will be
able to begin processing the new commands.
Syntax ViStatus _VI_FUNC hpe5250a_dcl(ViSession vi);
Parameters vi Instrument handle returned from hpe5250a_init( ).
hpe5250a_error_message
This function translates the error return value from an instrument driver function to
a readable string.
Syntax ViStatus _VI_FUNC hpe5250a_error_message(ViSession vi, ViStatus
error_number, ViChar _VI_FAR message[ ]);
Parameters vi Instrument handle returned from hpe5250a_init( ).
error_number Error return value from the driver function.
message[ ] Error message string. This is limited to 256 characters.
hpe5250a_error_query
This function returns the error numbers and corresponding error messages in the
error queue of a instrument. See Agilent E5250A User’s Guide for a listing of the
instrument error numbers and messages.
Instrument errors may occur when you places the instrument in a bad state such as