ViStatus _VI_FUNC niSync_CreateFutureTimeEvent (ViSession vi, ViConstString terminal, ViInt32 outputLevel, ViUInt32 timeSeconds, ViUInt32 timeNanoseconds, ViUInt16 timeFractionalNanoseconds);
Schedules a future time event. A future time event changes the digital signal at the terminal you specify—either from low to high or high to low—when the board time of the specified module reaches the time you specify with time. The future time event you create with this function is synchronized with the board time of the module you specify with instrument handle.
To create multiple future time events, invoke this function multiple times. Once you generate a future time event on a terminal, that terminal cannot be used for operations other than generating future time events until you clear all future time events with niSync_ClearFutureTimeEvents or you close the session with niSync_close. When you invoke this function, the digital signal on the specified terminal is driven low until the first future time event occurs.
![]() |
Note This attribute is supported only on certain targets. Refer to Target Support for Timing Attributes and Functions to determine whether or not this attribute is supported on your target. |
Name | Type | Description | ||
---|---|---|---|---|
vi | ViSession | The session handle that you obtain from niSync_init. The handle identifies a particular instrument session. | ||
terminal | ViConstString | Specifies the terminal whose digital signal will be changed by the future time event. | ||
outputLevel | ViInt32 | Specifies the level to set the digital signal to when the future time event occurs. Valid Values: NISYNC_VAL_LEVEL_LOW NISYNC_VAL_LEVEL_HIGH |
||
timeSeconds | ViUInt32 | Specifies, in seconds, the board time when the future time event occurs. When the board time of the module you specify in the vi attribute reaches this time, the digital signal of the terminal input changes to the value you specify in the outputLevel attribute. The default value of this input is 0, which triggers the future time event as soon as the function is invoked.
|
||
timeNanoseconds | ViUInt32 | Specifies, in nanoseconds, the board time when the future time event occurs. When the board time of the module you specify in the vi attribute reaches this time, the digital signal of the terminal input changes to the value you specify in the outputLevel attribute. The default value of this input is 0, which triggers the future time event as soon as the function is invoked.
|
||
timeFractionalNanoseconds | ViUInt16 | Specifies, in fractional nanoseconds, the board time when the future time event occurs. When the board time of the module you specify in the vi attribute reaches this time, the digital signal of the terminal input changes to the value you specify in the outputLevel attribute. The default value of this input is 0, which triggers the future time event as soon as the function is invoked.
|