KeInitializeTimer-Funktion (wdm.h)
Die KeInitializeTimer Routine initialisiert ein Timerobjekt.
Syntax
void KeInitializeTimer(
[out] PKTIMER Timer
);
Parameter
[out] Timer
Zeiger auf ein Timerobjekt, für das der Aufrufer den Speicher bereitstellt.
Rückgabewert
Nichts
Bemerkungen
Das Timerobjekt wird in einen nicht signalisierten Zustand initialisiert.
Der Speicher für ein Timerobjekt muss sich befinden: in der Geräteerweiterung eines vom Treiber erstellten Geräteobjekts, in der Controllererweiterung eines vom Treiber erstellten Controllerobjekts oder im vom Aufrufer zugewiesenen nicht ausgelagerten Pool.
KeInitializeTimer- kann nur einen Benachrichtigungszeitgeber initialisieren. Verwenden Sie KeInitializeTimerEx-, um einen Benachrichtigungszeitgeber 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 Objects and DPCs.
Aufrufer von KeInitializeTimer- sollten unter IRQL = DISPATCH_LEVEL oder niedriger ausgeführt werden. Es empfiehlt sich, Timer bei IRQL = PASSIVE_LEVEL zu initialisieren.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Ab Windows 2000 verfügbar. |
| Zielplattform- | Universal |
| Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | <= DISPATCH_LEVEL (siehe Abschnitt "Hinweise") |
| DDI-Complianceregeln | HwStorPortProhibitedDIs(storport), IrqlKeDispatchLte(wdm) |