KeInitializeTimer-Funktion (wdm.h)
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) |