IviSpecAn_SendSoftwareTrigger
Specific Function
C Function Prototype
ViStatus IviSpecAn_SendSoftwareTrigger (ViSession vi);
Purpose
This function sends a command to trigger the spectrum analyzer. Call this function if you pass IVISPECAN_VAL_TRIGGER_SOURCE_SOFTWARE for the IVISPECAN_ATTR_TRIGGER_SOURCE attribute or the Trigger Source parameter of the IviSpecAn_ConfigureTriggerSource function.
Notes:
(1) If the IVISPECAN_ATTR_TRIGGER_SOURCE is not set to the IVISPECAN_VAL_TRIGGER_SOURCE_SOFTWARE value, this function returns the Trigger Not Software error (0xBFFA1001).
(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 IviSpecAn_error_query function at the conclusion of the sequence.
Parameters
| Name | Type | Description |
|---|---|---|
| vi | ViSession | The ViSession handle that you obtain from the IviSpecAn_init or IviSpecAn_InitWithOptions function. The handle identifies a particular instrument session. Default Value: None |