WdfTimerStop-Funktion (wdftimer.h)

  • Artikel

[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)

Weitere Informationen

EvtTimerFunc

WdfTimerCreate

WdfTimerStart