IviDmm_ConfigureMultiPoint
IviDmmMultipoint Capability Group
C Function Prototype
ViStatus IviDmm_ConfigureMultiPoint (ViSession vi, ViInt32 triggerCount, ViInt32 sampleCount, ViInt32 sampleTrigger, ViReal64 sampleInterval);
Purpose
This function configures the attributes for multipoint measurements. These attributes include the trigger count, sample count, sample trigger, and sample interval.
Parameters
| Name | 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. |
| triggerCount | ViInt32 | Pass the number of triggers you want the DMM to receive before returning to the Idle state. The driver sets the IVIDMM_ATTR_TRIGGER_COUNT attribute to this value. |
| sampleCount | ViInt32 | Pass the number of measurements you want the DMM to take each time it receives a trigger. The driver sets the IVIDMM_ATTR_SAMPLE_COUNT attribute to this value. |
| sampleTrigger | ViInt32 | Pass the type of sample trigger you want to use. The driver sets the IVIDMM_ATTR_SAMPLE_TRIGGER attribute to this value. When the DMM takes a measurement and the sampleCount parameter is greater than 1, the DMM does not take the next measurement until the event you specify in the sampleTrigger parameter occurs. Defined Values |
| sampleInterval | ViReal64 | Pass the length of time in seconds you want the DMM to wait between samples. The driver sets the IVIDMM_ATTR_SAMPLE_INTERVAL attribute to this value. If the sampleCount parameter is greater than 1 and the sampleTrigger parameter is set to IVIDMM_VAL_INTERVAL, the DMM waits between measurements for the length of time you specify with this parameter. |