RtTimer.Change Method (Int32, Int32)

Set the expiration time and repeat interval on the specified timer.

Note: This method is non-deterministic.

IMPORTANT: This method have been deprecated. It will be removed in a future release.

Namespace: IntervalZero.MaxRT.wRTOS.RtApi.Threading
Assembly: IntervalZero.MaxRT.wRTOS (in IntervalZero.MaxRT.wRTOS.dll) Version: 1.0.0.0 (File version: 1.1.0)

Syntax

Copy

public bool Change(
    int dueTime,
    int period
)

Parameters

dueTime

Type: System.Int32
The amount of time to delay before callback is invoked. Specify System.Threading.Timeout.Infinite to prevent the timer from starting. Specify zero (0) to start the timer immediately. Expiration is calculated relative to the current value of the clock associated with the timer at creation. The clock is specified in 100ns units.

period

Type: System.Int32
The time interval between invocations of callback. If dueTime is not infinite specify zero (0) or System.Threading.Timeout.Infinite to disable periodic signaling(timer occurs only once). The clock is specified in 100ns units. See the comments section below for an explanation of "period" behavior.

Return Value

Type: Boolean
Value true if the current instance has not been disposed; otherwise, false.

Remarks

This function sets the relative expiration time and repeat interval for the specified timer. If the repeat interval is non-zero then, after the first expiration, the timer will repeatedly expire at the specified interval. If the repeat interval pointer is NULL, then the timer will expire only once (i.e., it is a "one-shot" timer). Likewise, a non-NULL interval pointer may be passed in, with its value set to zero, for a one-shot timer.

Upon each expiration of the timer, the handling thread is signaled to indicate the expiration, and the specified handling routine is run. The timer signals expirations only on the wRTOS timer interrupt boundaries. The wRTOS timer interval will be rounded up to the wRTOS HAL timer resolution. The highest RTX timer resolution is 1 ms. The behavior of the pInterval parameter is as follows:

If you set the wRTOS interval to less than the HAL timer period, wRTOS will set the interval equal to the HAL timer period.
The RTX interval must be a multiple of the HAL Timer period. If you specify an interval that is not a multiple of the HAL Timer period, wRTOS will force the interval to the closest multiple of the HAL Timer period.
Two timers with the same interval as the HAL Timer period will necessarily have the same phase. If you specify an interval that is less than the HAL timer period (default to 100 microseconds), wRTOS will use the HAL timer period as the wRTOS interval instead of the interval you specified.