Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
KeReadStateTimer
Collapse the table of content
Expand the table of content

KeReadStateTimer routine

The KeReadStateTimer routine reads the current state of a timer object.

Syntax


BOOLEAN KeReadStateTimer(
  _In_ PKTIMER Timer
);

Parameters

Timer [in]

A pointer to an initialized timer object, for which the caller provides the storage.

Return value

KeReadStateTimer returns TRUE if the current state of the timer object is signaled; otherwise, it returns FALSE.

Remarks

This routine provides an efficient way to poll the signal state of a timer. KeReadStateTimer reads the state of the timer without synchronizing its access to the timer. Do not assume that accesses of a timer state by KeReadStateTimer are mutually exclusive of accesses by routines, such as KeSetTimer and KeWaitForSingleObject, that do synchronize their access to the timer state.

For more information about timer objects, see Timer Objects and DPCs.

Requirements

Target platform

Universal

Version

Available starting with Windows 2000.

Header

Wdm.h (include Wdm.h, Ntddk.h, or Ntifs.h)

Library

NtosKrnl.lib

DLL

NtosKrnl.exe

IRQL

<= DISPATCH_LEVEL

DDI compliance rules

IrqlKeDispatchLte, HwStorPortProhibitedDDIs

See also

KeCancelTimer
KeInitializeTimer
KeSetTimer
KeWaitForSingleObject
KTIMER

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft