EVT_WDF_TIMER Rückruffunktion (wdftimer.h)
[Gilt für KMDF und UMDF]
Die EvtTimerFunc-Ereignisrückruffunktion wird aufgerufen, wenn ein angegebener Zeitraum abgelaufen ist.
Syntax
EVT_WDF_TIMER EvtWdfTimer;
void EvtWdfTimer(
[in] WDFTIMER Timer
)
{...}
Parameter
[in] Timer
Ein Handle für ein Framework-Timerobjekt, das aus einem vorherigen Aufruf von WdfTimerCreate abgerufen wurde.
Rückgabewert
Keine
Bemerkungen
Um eine EvtTimerFunc-Rückruffunktion zu registrieren und den Zeitraum anzugeben, der verstrichen sein soll, bevor das Framework diese Funktion aufruft, muss Ihr Treiber WdfTimerCreate aufrufen.
In KMDF-Versionen vor Version 1.9 implementiert das Framework EvtTimerFunc-Rückruffunktionen als verzögerte Prozeduraufrufe (DPCs). Wenn ein Zeitraum verstrichen ist, fügt das System daher einer DPC-Warteschlange einen Aufruf einer EvtTimerFunc-Rückruffunktion hinzu. Das System ruft die EvtTimerFunc-Rückruffunktion unter IRQL = DISPATCH_LEVEL auf, wenn sie die Front der Warteschlange erreicht und eine CPU verfügbar ist, die bei IRQL < DISPATCH_LEVEL ausgeführt wird.
In KMDF-Versionen 1.9 und höher implementiert das Framework standardmäßig EvtTimerFunc-Rückruffunktionen als DPCs. Wenn der Treiber die Ausführungsebene des Timerobjekts auf WdfExecutionLevelPassive festlegt, ruft das Framework die EvtTimerFunc-Rückruffunktion aus einem Arbeitselement unter IRQL = PASSIVE_LEVEL auf.
Hinweis
Wenn eine EvtTimerFunc-Rückruffunktion , die unter PASSIVE_LEVEL ausgeführt wird , WdfObjectDelete aufruft, führt dies zu einem Deadlock. Warten Sie stattdessen, bis das übergeordnete Element den Timer automatisch löscht, wenn das Gerät entfernt wird. Wenn Sie frühzeitig löschen müssen, planen Sie ein Arbeitselement aus dem Timerrückruf, um den Timer zu löschen.
Ab UMDF-Version 2.0 werden die EvtTimerFunc-Rückruffunktionen eines UMDF-Treibers immer auf PASSIVE_LEVEL ausgeführt.
Weitere Informationen zu Framework-Timerobjekten finden Sie unter Verwenden von Timern.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Universell |
KMDF-Mindestversion | 1.0 |
UMDF-Mindestversion | 2.0 |
Kopfzeile | wdftimer.h (include Wdf.h) |
IRQL | Weitere Informationen finden Sie im Abschnitt mit den Hinweisen. |