WdfTimerStop-Funktion (wdftimer.h)
[Gilt für KMDF und UMDF]
Die WdfTimerStop-Methode beendet die Uhr eines Timers.
Syntax
BOOLEAN WdfTimerStop(
[in] WDFTIMER Timer,
[in] BOOLEAN Wait
);
Parameter
[in] Timer
Ein Handle für ein Framework-Timerobjekt, das durch aufrufen von WdfTimerCreate abgerufen wurde.
[in] Wait
KMDF Ein boolescher Wert, der bei TRUE angibt, dass das Framework erst zurückgegeben wird, wenn alle Aufrufe der verzögerten Prozeduren (DPCs) des Treibers, einschließlich der EvtTimerFunc-Rückruffunktionen des Treibers, ausgeführt wurden.
UMDF Ein boolescher Wert, der bei TRUE angibt, dass das Framework erst zurückgegeben wird, wenn alle aufrufe der EvtTimerFunc-Rückruffunktion des Timers in der Warteschlange ausgeführt wurden.
Rückgabewert
WdfTimerStop gibt TRUE zurück, wenn sich das Timerobjekt in der Timerwarteschlange des Systems befand. Andernfalls gibt diese Methode FALSE zurück. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Hinweise
Wenn ein Treiber WdfTimerStart aufruft, wird sein Timerobjekt der Systemwarteschlange mit Timerobjekten hinzugefügt. Wenn der Timer kein regelmäßiger Timer ist, entfernt das System das Timerobjekt aus der Warteschlange, nachdem die "Fälligkeitszeit" des Timers abgelaufen ist. Wenn der Timer ein periodischer Timer ist, verbleibt das Timerobjekt in der Warteschlange, bis der Treiber WdfTimerStop aufruft.
Weitere Informationen zu Frameworktimerobjekten finden Sie unter Verwenden von Timern.
WdfTimerStop muss unter IRQL = PASSIVE_LEVEL aufgerufen werden, wenn der Wait-ParameterTRUE ist. Andernfalls muss diese Methode unter IRQL <= DISPATCH_LEVEL aufgerufen werden.
Rufen Sie WdfTimerStop nicht in EvtTimerFunc auf, wenn der Wait-Parameter auf TRUE festgelegt ist. Dies kann zu einem Deadlock führen.
Beispiele
Das folgende Codebeispiel beendet einen angegebenen Timer und wartet, bis alle DPCs in der Warteschlange des Treibers ausgeführt werden.
WdfTimerStop(
timerHandle,
TRUE
);
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Universell |
KMDF-Mindestversion | 1.0 |
UMDF-Mindestversion | 2.0 |
Kopfzeile | wdftimer.h (einschließen von Wdf.h) |
Bibliothek | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
IRQL | Weitere Informationen finden Sie im Abschnitt mit den Hinweisen. |
DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |