INtime SDK Help
RtCreateTimer (iwin32)
INtime SDK v6 > About INtime > Alternate APIs > iwin32 API > iwin32 API > RtCreateTimer (iwin32)

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

Versions Defined in Include Link to
INtime 3.0 intime/rt/include/iwin32.h iwin32.h iwin32.lib

Note

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

See Also