KeInitializeTimer

VOID
KeInitializeTimer(

IN PKTIMER Timer
);

KeInitializeTimer initializes a timer object.

Parameters

Timer

Points to a timer object, for which the caller provides the storage.

Comments

The timer object is initialized with a state of Not-Signaled.

Storage for a timer object must be resident: in the device extension of a driver-created device object, in the controller extension of a driver-created controller object, or in nonpaged pool allocated by the caller.

KeInitializeTimer can only initialize a notification timer. Use KeInitializeTimerEx to initialize a notification timer or a synchronization timer.

Callers of KeInitializeTimer should be running at IRQL DISPATCH_LEVEL or lower. It is best to initialize timers at IRQL PASSIVE_LEVEL.

Use KeSetTimer or KeSetTimerEx to define when the timer will expire.

See Also

KeCancelTimer, KeInitializeTimerEx, KeReadStateTimer, KeSetTimer, KeSetTimerEx, KeWaitForMultipleObjects, KeWaitForSingleObject