Creates a timer thread that regularly calls a user-supplied function. To start the timer counting, call either RtSetTimer or RtSetTimerRelative.

HANDLE RtCreateTimer(
    PSECURITY_ATTRIBUTES pThreadAttributes,
    ULONG dwStackSize,
    VOID (RTFCNDCL * Routine) (PVOID Context),
    PVOID Context,
    ULONG Priority,
    CLOCK Clock
);

Parameters

pThreadAttributes

Ignored. Set to Null.

dwStackSize

Number of bytes to allocate to the new thread's stack.

Routine

Pointer to the function to call when the timer expires.

Context

Pointer passed on every call to Routine.

Priority

Thread priority for the handler routine, specified as a value between 0 (lowest priority) and 127 (highest priority).

Clock

Ignored.

Remarks

dwStackSize is ceiled to a multiple of 4K bytes.

Return Values

Handle to timer object

Success.

NULL

Failure. For extended error information, see GetLastError.

Requirements

Note

This function operates in the real-time portion of your application.