EVT_WDF_IO_QUEUE_STATE Rückruffunktion (wdfio.h)
[Gilt für KMDF und UMDF]
Die EvtIoQueueState-Ereignisrückruffunktion eines Treibers übermittelt Warteschlangenstatusinformationen an den Treiber.
Syntax
EVT_WDF_IO_QUEUE_STATE EvtWdfIoQueueState;
void EvtWdfIoQueueState(
[in] WDFQUEUE Queue,
[in] WDFCONTEXT Context
)
{...}
Parameter
[in] Queue
Ein Handle für ein E/A-Warteschlangenobjekt.
[in] Context
Vom Treiber definierte Kontextinformationen, die der Treiber bei der Registrierung der EvtIoQueueState-Rückruffunktion angegeben hat.
Rückgabewert
Keine
Bemerkungen
Treiber können eine EvtIoQueueState-Rückruffunktion registrieren, indem sie ihre Adresse als Eingabe für WdfIoQueueStop, WdfIoQueueDrain, WdfIoQueuePurge oder WdfIoQueueReadyNotify angeben. Das Framework ruft die EvtIoQueueState-Rückruffunktion auf, nachdem der angegebene Vorgang abgeschlossen ist.
Die EvtIoQueueState-Rückruffunktion kann unter IRQL <= DISPATCH_LEVEL aufgerufen werden, es sei denn, der ExecutionLevel-Member der WDF_OBJECT_ATTRIBUTES der Warteschlange ist auf WdfExecutionLevelPassive festgelegt. In diesem Fall wird sie unter IRQL = PASSIVE_LEVEL aufgerufen. Wenn die Warteschlange WdfExecutionLevelInheritFromParent angibt, kann die Eigenschaft vom WDFDEVICE- oder WDFDRIVER-WDF_OBJECT_ATTRIBUTES geerbt werden.
Wenn der IRQL PASSIVE_LEVEL ist, ruft das Framework die Rückruffunktion in einem kritischen Bereich auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| UMDF-Mindestversion | 2.0 |
| Kopfzeile | wdfio.h (einschließen von Wdf.h) |
| IRQL | <= DISPATCH_LEVEL (siehe Abschnitt "Hinweise") |