GxDmmGetFunction

Purpose

Returns the currently selected function

Syntax

GxDmmGetFunction (nHandle, pdwFunction, pnStatus)

Parameters

Name
Type
Comments
nHandle
SHORT
Handle for a GX2065 board.
pdwFunction
PDWORD
Return the currently set function:
  1. GXDMM_FUNCTION_VDC –Voltage DC Mode
  2. GXDMM_FUNCIONT_IDC – Current DC Mode
  3. GXDMM_FUNCTION_VAC_AC_CPL – Voltage AC, AC Coupled Mode
  4. GXDMM_FUNCTION_IAC_AC_CPL – Current AC, AC Coupled Mode
  5. GXDMM_FUNCTION_VAC_DC_CPL – Voltage AC, DC Coupled Mode
  6. GXDMM_FUNCTION_IAC_DC_CPL – Current AC, DC Coupled Mode
  7. GXDMM_FUNCTION_2WIRE_OHM – 2Wire Resistance Mode
  8. GXDMM_FUNCTION_4WIRE_OHM – 4 Wire Resistance Mode
  9. GXDMM_FUNCTION_CONTINUITY – High Resolution Continuity Mode
  10. GXDMM_FUNCTION_FREQUENCY – Frequency Counter Mode
  11. GXDMM_FUNCTION_DIODE – Diode Voltage Mode
  12. GXDMM_FUNCTION_TEMPERATURE – External Temperature Mode
  13. GXDMM_FUNCTION_BOARD_TEMPERATURE – Internal, Board Temperature Mode
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

The GX2065 can be set to several different function modes. When the function is changed, the min/max accumulator is cleared and any ongoing measurement is aborted. If the current reading trigger is not set to software trigger, changing the function will result in the reading trigger being set to software trigger, briefly, and then back to its previous setting.

Example

The following example gets the current function:

 

SHORT nHandle, nStatus;

DWORD dwFunction;

 

GxDmmGetFunction (nHandle, &dwFunction, &nStatus);

 

See Also

GxDmmSetFunction, GxDmmSetRange, GxDmmGetRange, GxDmmSetTriggerMode, GxDmmGetTriggerMode,  GxDmmGetErrorString