|NI-SCOPE (English | Japanese)|
ViStatus niScope_ConfigureTriggerWindow (ViSession vi, ViConstString triggerSource, ViReal64 lowLevel, ViReal64 highLevel, ViInt32 windowMode, ViInt32 triggerCoupling, ViReal64 holdoff, ViReal64 delay);
Configures common properties for analog window triggering. A window trigger occurs when a signal enters or leaves a window you specify with the high level or low level parameters.
When you initiate an acquisition, the digitizer waits for the start trigger, which is configured through the NISCOPE_ATTR_ACQ_ARM_SOURCE (Start Trigger Source) attribute. The default is immediate. Upon receiving the start trigger the digitizer begins sampling pretrigger points. After the digitizer finishes sampling pretrigger points, the digitizer waits for a reference (stop) trigger that you specify with a function such as this one. Upon receiving the reference trigger the digitizer finishes the acquisition after completing posttrigger sampling. With each Configure Trigger function, you specify configuration parameters such as the trigger source and the amount of trigger delay.
To trigger the acquisition, use niScope_SendSoftwareTriggerEdge.
|Note Some features are not supported by all digitizers. Refer to Features Supported by Device for more information.|
|vi||ViSession||The instrument handle you obtain from niScope_init that identifies a particular instrument session.|
|triggerSource||ViConstString||Specifies the trigger source. Refer to NISCOPE_ATTR_TRIGGER_SOURCE for defined values.|
|lowLevel||ViReal64||Passes the voltage threshold you want the digitizer to use for low triggering.|
|highLevel||ViReal64||Passes the voltage threshold you want the digitizer to use for high triggering.|
|windowMode||ViInt32||Specifies whether you want the trigger to occur when the signal enters or leaves a window.|
|triggerCoupling||ViInt32||Applies coupling and filtering options to the trigger signal. Refer to NISCOPE_ATTR_TRIGGER_COUPLING for more information.|
|holdoff||ViReal64||The length of time the digitizer waits after detecting a trigger before enabling NI-SCOPE to detect another trigger. Refer to NISCOPE_ATTR_TRIGGER_HOLDOFF for more information.|
|delay||ViReal64||How long the digitizer waits after receiving the trigger to start acquiring data. Refer to NISCOPE_ATTR_TRIGGER_DELAY_TIME for more information.|
|Status||ViStatus||Reports the status of this operation. To obtain a text description of the status code,
To obtain additional information concerning the error
condition, use niScope_GetError
The general meaning of the status code is as follows:|