GxDmmGetTriggerMode

Purpose

Returns the trigger mode

Syntax

GxDmmGetTriggerMode (nHandle, pdwTriggerMode, pnStatus)

Parameters

Name
Type
Comments
nHandle
SHORT
Handle for a GX2065 board.
pdwTriggerMode
PDWORD
Returns the measurement in terms of digits of resolution.
0. GXDMM_TRIGGER_CONTINUOUS – The DMM will take readings as fast as possible. Measurements can be read by calling GxDmmRead or GxDmmReadEx (get the measurements from the DMM as fast as possible without buffering).
1. GXDMM_TRIGGER_TIMER – A programmable timer is used to trigger a measurement. The timer period in seconds is passed in using the dwCountOrInterval parameter.
2. GXDMM_TRIGGER_EXTERNAL – The PXI Bus is used to trigger a measurement
3. GXDMM_TRIGGER_SOFTWARE – A Software Trigger will trigger a measurement
4. GXDMM_TRIGGER_ARRAY – Trigger a continuous burst of measurements and store them in the onboard buffer memory. The measurements can be retrieved at a later time by calling GxDmmReadArray. The number of measurements is specified in the dwCountOrInterval parameter.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

The Trigger Reading mode determines the trigger source used to initiate a measurement.

Note that the Timer Interval and Array Count parameters can only be set, not read back. Also, the GXDMM_TRIGGER_ARRAY mode cannot be read back because it is a temporary, one-shot mode that reverts back to Software mode as soon as it has finished with its measurements. Once the trigger mode has been set to Array, its completion can be checked by calling GxDmmGetReadArrayStatus. Any pending measurement operation can be cancelled by calling GxDmmAbortReading.

Use GxDmmSetExternalTriggers to configure PXI Trigger Line, PXI STAR trigger and LINK triggers when setting the trigger mode to GXDMM_TRIGGER_EXTERNAL

Example

The following example gets the trigger mode:

 

SHORT nHandle, nStatus;

DWORD dwTriggerMode;

 

GxDmmGetTriggerMode (nHandle, &dwTriggerMode, &nStatus);

 

See Also

GxDmmSetTriggerMode, GxDmmSetExternalTriggers, GxDmmGetExternalTriggers, GxDmmSetRange, GxDmmGetRange, GxDmmSetFunction, GxDmmGetFunction, GxDmmGetErrorString