niDMM_ConfigureWaveformAcquisition
ViStatus = niDMM_ConfigureWaveformAcquisition(ViSession Instrument_Handle, ViInt32 Measurement_Function, ViReal64 Range, ViReal64 Rate, ViInt32 Waveform_Points)
Purpose
Configures the NI 4070/4071/4072 for waveform acquisitions.
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. | ||||||
Measurement_Function | ViInt32 | Specifies the Measurement_Function used in a waveform acquisition. The driver sets
NIDMM_ATTR_FUNCTION to this value.
|
||||||
Range | ViReal64 | Specifies the expected maximum amplitude of the input signal and sets the Range for the Measurement_Function. NI-DMM sets
NIDMM_ATTR_RANGE to this value. Range values are coerced up to the closest input Range. The default is 10.0.
For valid ranges refer to the topics in Devices. Auto-ranging is not supported during waveform acquisitions. |
||||||
Rate | ViReal64 | Specifies the Rate of the acquisition in samples per second. NI-DMM sets
NIDMM_ATTR_WAVEFORM_RATE to this value.
The valid Range is 10.0–1,800,000 S/s. Rate values are coerced to the closest integer divisor of 1,800,000. The default value is 1,800,000. |
||||||
Waveform_Points | ViInt32 | Specifies the number of points to acquire before the waveform acquisition completes. NI-DMM sets
NIDMM_ATTR_WAVEFORM_POINTS to this value. To calculate the maximum and minimum number of waveform points that you can acquire in one acquisition, refer to the Waveform Acquisition Measurement Cycle. The default value is 500. |
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. |