niDMM_FormatMeasAbsolute

NI-DMM C/CVI/VB

niDMM_FormatMeasAbsolute

ViStatus = niDMM_FormatMeasAbsolute(ViInt32 Measurement_Function, ViReal64 Range, ViReal64 Resolution, ViReal64 Measurement, ViChar Mode_String[], ViChar Range_String[], ViChar Data_String[])

Purpose

Formats the Measurement to the proper number of displayed digits according to the Measurement_Function, Range, and Resolution. Returns the formatted data, range, and mode strings.

Parameters

Input
Name Type Description
Measurement_Function ViInt32 Specifies the Measurement_Function used to acquire the measurement. The driver sets NIDMM_ATTR_FUNCTION to this value.
Range ViReal64 Specifies the NIDMM_ATTR_RANGE used to acquire the Measurement.
Resolution ViReal64 Specifies the NIDMM_ATTR_RESOLUTION_ABSOLUTE of the Measurement.
Measurement ViReal64 Specifies the measured value returned from the DMM.
Output
Name Type Description
Mode_String ViChar[] Returns a string containing the units of the Measurement mode.
Range_String ViChar[] Returns the NIDMM_ATTR_RANGE of the Measurement, formatted into a string with the correct number of display digits.
Data_String ViChar[] Returns the Measurement, formatted according to the NIDMM_ATTR_FUNCTION, NIDMM_ATTR_RANGE, and NIDMM_ATTR_RESOLUTION_ABSOLUTE.

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.