niDMM_ConfigureMultiPoint

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_TRIGGER.

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. Note  To determine which values are supported by each device, refer to the LabWindows/CVI Trigger Routing section.
Sample_Interval	ViReal64	Sets the amount of time in seconds the DMM waits between measurements. The driver sets NIDMM_ATTR_SAMPLE_INTERVAL to this value. Specify a sample interval to add settling time between measurements 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 measurements. 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. Note  This attribute is not used on the NI 4050.

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.