KeInitializeTimer-Funktion (wdm.h)

Artikel
02/27/2024

Die KeInitializeTimer-Routine initialisiert ein Timerobjekt.

Syntax

void KeInitializeTimer(
  [out] PKTIMER Timer
);

Parameter

[out] Timer

Zeiger auf ein Zeitgeberobjekt, für das der Aufrufer den Speicher bereitstellt.

Rückgabewert

Keine

Bemerkungen

Das Timerobjekt wird in einen nicht signalisierten Zustand initialisiert.

Der Speicher für ein Zeitgeberobjekt muss sich in der Geräteerweiterung eines vom Treiber erstellten Geräteobjekts, in der Controllererweiterung eines vom Treiber erstellten Controllerobjekts oder in einem nicht ausgelagerten Pool befinden, der vom Aufrufer zugewiesen wird.

KeInitializeTimer kann nur einen Benachrichtigungszeitgeber initialisieren. Verwenden Sie KeInitializeTimerEx , um einen Benachrichtigungstimer oder einen Synchronisierungszeitgeber zu initialisieren.

Verwenden Sie KeSetTimer oder KeSetTimerEx , um zu definieren, wann der Timer abläuft.

Weitere Informationen zu Timerobjekten finden Sie unter Timer-Objekte und DPCs.

Aufrufer von KeInitializeTimer sollten unter IRQL = DISPATCH_LEVEL oder niedriger ausgeführt werden. Es ist am besten, Timer bei IRQL = PASSIVE_LEVEL zu initialisieren.

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 (siehe Abschnitt Hinweise)
DDI-Complianceregeln	HwStorPortProhibitedDDIs(storport), IrqlKeDispatchLte(wdm)