KeInitializeTimerEx-Funktion (wdm.h)

Artikel
02/27/2024

Die KeInitializeTimerEx-Routine initialisiert ein erweitertes Kerneltimerobjekt.

Syntax

void KeInitializeTimerEx(
  [out] PKTIMER    Timer,
  [in]  TIMER_TYPE Type
);

Parameter

[out] Timer

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

[in] Type

Gibt den Typ des Timerobjekts an, entweder NotificationTimer oder SynchronizationTimer.

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.

Wenn ein Benachrichtigungszeitgeber abläuft, werden alle wartenden Threads freigegeben, und der Timer bleibt im signalierten Zustand, bis er explizit zurückgesetzt wird. Wenn ein Synchronisierungszeitgeber abläuft, wird er auf einen signalierten Zustand festgelegt, bis ein einzelner wartenden Thread freigegeben wird und dann der Timer auf einen nicht signalierten Zustand zurückgesetzt wird.

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

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

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

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)