IviPwrMeter_SendSoftwareTrigger
Specific Function
C Function Prototype
ViStatus IviPwrMeter_SendSoftwareTrigger (ViSession vi);
Purpose
This function sends a command to trigger the power meter. Call this function if you pass IVIPWRMETER_VAL_SOFTWARE_TRIG for the IVIPWRMETER_ATTR_TRIGGER_SOURCE attribute or the Trigger Source parameter of the IviPwrMeter_ConfigureTriggerSource function.
Notes:
(1) If the IVIPWRMETER_ATTR_TRIGGER_SOURCE is not set to the IVIPWRMETER_VAL_SOFTWARE_TRIG value, this function returns a Trigger Not Software (0xBFFA1001) error.
(2) This function does not check the instrument status. Typically, you call this function only in a sequence of calls to other low-level driver functions. The sequence performs one operation. You use the low-level functions to optimize one or more aspects of interaction with the instrument. If you want to check the instrument status, call the IviPwrMeter_error_query function at the conclusion of the sequence.
Parameters
| Name | Type | Description |
|---|---|---|
| vi | ViSession | The ViSession handle that you obtain from the IviPwrMeter_init or IviPwrMeter_InitWithOptions function. The handle identifies a particular instrument session. Default Value: None |