EVT_WDF_IO_QUEUE_STATE Rückruffunktion (wdfio.h)

  • Artikel

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

Weitere Informationen

WDF_OBJECT_ATTRIBUTES

WdfIoQueueDrain

WdfIoQueuePurge

WdfIoQueueReadyNotify

WdfIoQueueStop