IviSpecAn_Initiate
IviSpecAnBase Capability Group
C Function Prototype
ViStatus IviSpecAn_Initiate (ViSession vi);
Purpose
This function initiates an acquisition. After calling this function, the spectrum analyzer leaves the idle state and waits for a trigger.
Notes:
(1) 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.
(2) Call IviSpecAn_AcquisitionStatus to determine when the acquisition is complete.
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 |