Note

id

debugLevel

debugLevelPtr

Agilent E1439 Programmer's Reference

Functions listed alphabetically

age1439_driver_debug_level

Sets and gets the debug level.

VXIplug&play Syntax

#include "age1439".h

ViStatus age1439_driver_debug_level(ViSession id, ViInt16 debugLevel); ViStatus age1439_driver_debug_level_get(ViSession id, ViPInt16 debugLevelPtr);

Description

This command allows you to set and get debug levels. Debug messages are sent to the application debugger using the Windows kernel function Output Debug String.

This function only works under Windows.

This function only works with a debug build of the library.

Debug messages are received by the Microsoft Visual C++ debugger or can be received by the dbmon example program that comes with Microsoft Visual C++.

You can compile a DEBUG build by opening age1439_32.dsw, the Visual C++ project for the driver DLL, age1439_32.dll, and selecting the "age1439_32.dl-Win32 Debug" build configuration.

Parameters

is the VXI instrument session pointer returned by the age1439_init function.

is the debug level.

 

points to the value of debugLevel.

 

Debug levels are defined as follows:

 

 

Debug Level

Description

 

 

 

 

AGE1439_DEBUG_LEVEL_0

Only output errors and algorithmic results

 

AGE1439_DEBUG_LEVEL_1

Add output of setup function calls

 

AGE1439_DEBUG_LEVEL_2

Add output of measurement function calls

 

AGE1439_DEBUG_LEVEL_3

Add output of status query function calls

 

AGE1439_DEBUG_LEVEL_4

Reserved

 

AGE1439_DEBUG_LEVEL_5

Add output of diagnostic function calls

Return Value

AGE1439_SUCCESS indicates that a function was successful.

Values other than AGE1439_SUCCESS indicate an error condition or other important status condition. To determine the error message, pass the return value to “age1439_error_message” on page 102.

See Also

“age1439_init” on page 132

97

Page 107
Image 107
Agilent Technologies E1439 manual Age1439driverdebuglevel, DebugLevel DebugLevelPtr