KeResetEvent-Funktion (wdm.h)

Artikel
02/27/2024

Die KeResetEvent-Routine setzt ein angegebenes Ereignisobjekt auf einen nicht signalierten Zustand zurück und gibt den vorherigen Zustand dieses Ereignisobjekts zurück.

Syntax

LONG KeResetEvent(
  [in, out] PRKEVENT Event
);

Parameter

[in, out] Event

Ein Zeiger auf ein initialisiertes Dispatcherobjekt vom Typ Ereignis, für das der Aufrufer den Speicher bereitstellt.

Rückgabewert

KeResetEvent gibt einen Wert zurück, der den vorherigen Zustand des angegebenen Ereignisses angibt, der für einen signalierten Zustand ungleich null ist.

Hinweise

Das Ereignis wird auf einen nicht signalisierenden Zustand zurückgesetzt, was bedeutet, dass sein Wert auf 0 (null) festgelegt ist.

Es sei denn, der Aufrufer benötigt den wert, der von KeResetEvent zurückgegeben wird, ist die Verwendung der KeClearEvent-Routine eine schnellere Möglichkeit, ein Ereignisobjekt auf einen nicht signalisierenden Zustand festzulegen.

Weitere Informationen zu Ereignisobjekten finden Sie unter Ereignisobjekte.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 2000.
Zielplattform	Universell
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<=DISPATCH_LEVEL
DDI-Complianceregeln	HwStorPortProhibitedDIs(storport), IrqlKeDispatchLte(wdm)