IviDmm_IsOverRange

CVI/LabWindows IVI Class Driver

IviDmm_IsOverRange

IviDmmBase Capability Group

C Function Prototype

ViStatus IviDmm_IsOverRange (ViSession vi, ViReal64 measurementValue, ViBoolean *isOverRange);

Purpose

This function takes a measurement value that you obtain from one of the Read or Fetch functions and determines if the value is a valid measurement value or a value indicating that an overrange condition occurred.

If an overrange condition occurs, the measurement value contains an IEEE defined NaN (Not a Number) value indicating that an overrange occurred.

Parameters

Inputs Type Description
vi ViSession The instrument handle that you obtain from the IviDmm_init or IviDmm_InitWithOptions functions. The handle identifies a particular IVI session.
measurementValue ViReal64 Pass the measurement value that you obtain from one of the Read or Fetch functions. The driver tests this value to determine if the value is a valid measurement value or a value indicating that an overrange condition occurred.

Note  If an overrange condition occurs, the measurement value contains an IEEE defined NaN (Not a Number) value indicating that an overrange occurred.
     
Outputs Type Description
isOverRange ViBoolean Returns whether the measured value is a valid measurement or a value indicating that an overrange condition occurred.

Valid Return Values:

VI_TRUE (1)—The value indicates an overrange condition occurred.

VI_FALSE (0)—The value is a valid measurement.

Return Values