Agilent Technologies B1500A User's Guide download pdf (Page 40)

2-24 Agilent B1500 VXIplug&play Driver User’s Guide, Edition 3

Driver Functions

agb1500_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 agb1500_dcl(ViSession vi);

Parameters vi Instrument handle returned from agb1500_init( ).

agb1500_error_message

This function translates the error return value from an instrument driver function to

a readable string.

Syntax ViStatus _VI_FUNC agb1500_error_message(ViSession vi, ViStatus error_number,

ViChar _VI_FAR message[ ] );

Parameters vi Instrument handle returned from agb1500_init( ).

error_number Error return value from the driver function.

message[ ] Error message string. Returned data. This is limited to 256

characters.

agb1500_error_query

This function returns the error numbers and corresponding error messages in the

error queue of an instrument. See Agilent B1500 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 sending an invalid sequence of coupled

commands. Instrument errors can be detected by polling. Automatic polling can be

accomplished by using the agb1500_errorQueryDetect function.

Syntax ViStatus _VI_FUNC agb1500_error_query(ViSession vi, ViPInt32 error_number,

ViChar _VI_FAR error_message[ ] );

Parameters vi Instrument handle returned from agb1500_init( ).

error_number Instrument’s error code. Returned data.

1 2 ... 35 36 37 38 39 40 41 42 43 44 45 ... 207 208

No comments

Agilent Technologies B1500A User's Guide Page 40