Agilent Technologies 8164A Manual De Usuario

The Agilent 816x VXIplug&play Instrument Driver

Error Handling

230

Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition

Events and errors within a instrument control program can be detected by 
polling (querying) the instrument. Polling is used in application 
development environments (ADEs) that do not support asynchronous 
activities where callbacks can be used. 

Programs can set up and use polling as shown below.

Declare a variable to contain the function completion code.

ViStatus errStatus;

Every driver function returns the completion code 

ViStatus

. 

If the function executes with no I/O errors, driver errors, or instrument 

errors, 

ViStatus

 is 0 (

VI_SUCCESS

). 

If an error occurs, 

ViStatus

 is a negative error code. 

Warnings are positive error codes, and indicate the operation 

succeeded but special conditions exist. 

Enable automatic instrument error checking following each function 

call.

hp816x_errorQueryDetect
(instrumentHandle, VI_TRUE);

When enabled, the driver queries the instrument for an error condition 

before returning from the function. 

If an error occurred, 

errStatus

 (Step 1) will contain a code indicating that 

an error was detected (

hp816x_INSTR_ERROR_DETECTED

).

Check for an error (or event) after each function.

errStatus = hp816x_cmd(instrumentHandle, "SENS1:POW:RANG");

check(instrumentHandle, errStatus);

After the function executes, 

errStatus

 contains the completion code. 

The completion code and instrument ID are passed to an error checking 

routine. In the above statement, the routine is called 'check'.

Create a routine to respond to the error or event. This example queries 

whether an error has occured, checks if the error is an instrument error 

and then checks if the error is a driver error.