EVT_WDF_IO_QUEUE_STATE Rückruffunktion (wdfio.h)
[Gilt für KMDF und UMDF]
Die EvtIoQueueState Ereignisrückruffunktion eines Treibers liefert Informationen zum Warteschlangenstatus an den Treiber.
Syntax
EVT_WDF_IO_QUEUE_STATE EvtWdfIoQueueState;
void EvtWdfIoQueueState(
[in] WDFQUEUE Queue,
[in] WDFCONTEXT Context
)
{...}
Die Parameter
[in] Queue
Ein Handle zu einem E/A-Warteschlangenobjekt.
[in] Context
Treiberdefinierte Kontextinformationen, die der Treiber beim Registrieren der EvtIoQueueState Rückruffunktion angegeben hat.
Rückgabewert
Nichts
Bemerkungen
Treiber können eine EvtIoQueueState Rückruffunktion registrieren, indem sie ihre Adresse als Eingabe für WdfIoQueueStop, WdfIoQueueDrain, WdfIoQueuePurgeoder WdfIoQueueReadyNotifyangeben. Das Framework ruft die EvtIoQueueState Rückruffunktion auf, nachdem der angegebene Vorgang abgeschlossen wurde.
Die EvtIoQueueState Rückruffunktion kann bei IRQL-<= DISPATCH_LEVEL aufgerufen werden, es sei denn, der ExecutionLevel Member der WDF_OBJECT_ATTRIBUTES der Warteschlange ist auf WdfExecutionLevelPassivefestgelegt, in diesem Fall wird es bei IRQL = PASSIVE_LEVEL aufgerufen. Wenn die Warteschlange WdfExecutionLevelInheritFromParentangibt, kann die Eigenschaft von der WDF_OBJECT_ATTRIBUTESvon WDFDEVICE oder WDFDRIVER geerbt werden.
Wenn die IRQL PASSIVE_LEVEL ist, ruft das Framework die Rückruffunktion innerhalb eines kritischen Bereichsauf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | universell |
| Minimale KMDF-Version | 1.0 |
| Mindest-UMDF-Version | 2.0 |
| Kopfzeile | wdfio.h (einschließen Wdf.h) |
| IRQL | <= DISPATCH_LEVEL (siehe Abschnitt "Hinweise") |