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.

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

Weitere Informationen

WdfTimerErstellen