niDMM_GetMeasurementPeriod

NI-DMM C/CVI/VB

niDMM_GetMeasurementPeriod

ViStatus = niDMM_GetMeasurementPeriod(ViSession Instrument_Handle, ViReal64 *Period)

Purpose

Returns the measurement Period, which is the amount of time it takes to complete one measurement with the current configuration. Use this function right before you begin acquiring data—after you have completely configured the measurement and after all configuration functions have been called.

Parameters

Input
Name Type Description
Instrument_Handle ViSession Identifies a particular instrument session. You obtain the Instrument_Handle parameter from niDMM_init or niDMM_InitWithOptions. The default is None.
Output
Name Type Description
Period ViReal64* Returns the number of seconds it takes to make one measurement.

The first measurement in a multipoint acquisition requires additional settling time. This function does not include this additional time or any NIDMM_ATTR_TRIGGER_DELAY associated with the first measurement. Time required for internal measurements, such as NIDMM_ATTR_AUTO_ZERO, is included.

Return Value

Name Type Description
Status ViStatus Reports the Status of this operation. To obtain a text description of the status code, call niDMM_error_message. To obtain additional information concerning the error condition, use niDMM_GetError.