KeResetEvent function

The KeResetEvent routine resets a specified event object to a not-signaled state and returns the previous state of that event object.

Syntax

LONG KeResetEvent(
  PRKEVENT Event
);

Parameters

Event

A pointer to an initialized dispatcher object of type event for which the caller provides the storage.

Return Value

KeResetEvent returns a value that indicates the previous state of the specified Event, which is nonzero for a signaled state.

Remarks

Event is reset to a not-signaled state, meaning that its value is set to zero.

Unless the caller requires the value that is returned by KeResetEvent, using the KeClearEvent routine is a faster way to set an event object to a not-signaled state.

For more information about event objects, see Event Objects.

Requirements

   
Minimum supported client Available starting with Windows 2000.
Target Platform Universal
Header wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL "<=DISPATCH_LEVEL"
DDI compliance rules IrqlKeDispatchLte, HwStorPortProhibitedDDIs

See Also

KeClearEvent

KeInitializeEvent

KeReadStateEvent

KeSetEvent

KeWaitForMultipleObjects

KeWaitForSingleObject