niDMM_ConfigureMultiPoint
- Updated2023-02-21
- 2 minute(s) read
ViStatus = niDMM_ConfigureMultiPoint(ViSession Instrument_Handle, ViInt32 Trigger_Count, ViInt32 Sample_Count, ViInt32 Sample_Trigger, ViReal64 Sample_Interval)
Purpose
Configures the attributes for multipoint measurements. These attributes include NIDMM_ATTR_TRIGGER_COUNT, NIDMM_ATTR_SAMPLE_COUNT, NIDMM_ATTR_SAMPLE_TRIGGER, and NIDMM_ATTR_SAMPLE_INTERVAL.
For continuous acquisitions, set NIDMM_ATTR_TRIGGER_COUNT or NIDMM_ATTR_SAMPLE_COUNT to zero. For more information, refer to Multiple Point Acquisitions, Triggering, and Using Switches.
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. | ||
| Trigger_Count | ViInt32 | Sets the number of triggers you want the DMM to receive before returning to the Idle state. The driver sets NIDMM_ATTR_TRIGGER_COUNT to this value. The default value is 1. | ||
| Sample_Count | ViInt32 | Sets the number of measurements the DMM makes in each measurement sequence initiated by a trigger. The driver sets NIDMM_ATTR_SAMPLE_COUNT to this value. The default value is 1. | ||
| Sample_Trigger | ViInt32 | Specifies the Sample_Trigger source you want to use. The driver sets
NIDMM_ATTR_SAMPLE_TRIGGER to this value. The default is Immediate.
|
||
| Sample_Interval | ViReal64 | Sets the amount of time in seconds the DMM waits between measurement cycles. The driver sets
NIDMM_ATTR_SAMPLE_INTERVAL to this value. Specify a sample interval to add settling time between measurement cycles or to decrease the measurement rate. Sample_Interval only applies when the Sample_Trigger is set to INTERVAL. On the NI 4060, the Sample_Interval value is used as the settling time. When sample interval is set to 0, the DMM does not settle between measurement cycles. The NI 4065 and NI 4070/4071/4072 use the value specified in Sample_Interval as additional delay. The default value (-1) ensures that the DMM settles for a recommended time. This is the same as using an Immediate trigger.
|
||
Return Value
| Name | Type | Description |
| Status | ViStatus | Reports the Status of this operation. To obtain a text description of the status code, call niDMM_GetErrorMessage. To obtain additional information concerning the error condition, use niDMM_GetError. |