EVT_WDF_IO_QUEUE_IO_DEFAULT Rückruffunktion (wdfio.h)

Artikel
02/27/2024

[Gilt für KMDF und UMDF]

Die EvtIoDefault-Ereignisrückruffunktion eines Treibers verarbeitet eine angegebene E/A-Anforderung.

Syntax

EVT_WDF_IO_QUEUE_IO_DEFAULT EvtWdfIoQueueIoDefault;

void EvtWdfIoQueueIoDefault(
  [in] WDFQUEUE Queue,
  [in] WDFREQUEST Request
)
{...}

Parameter

[in] Queue

Ein Handle für das Frameworkwarteschlangenobjekt, das der E/A-Anforderung zugeordnet ist.

[in] Request

Ein Handle für ein Frameworkanforderungsobjekt.

Rückgabewert

Keine

Bemerkungen

Ein Treiber registriert eine EvtIoDefault-Rückruffunktion , wenn er WdfIoQueueCreate aufruft. Weitere Informationen zum Aufrufen von WdfIoQueueCreate finden Sie unter Erstellen von E/A-Warteschlangen.

Wenn ein Treiber eine EvtIoDefault-Rückruffunktion für die E/A-Warteschlange eines Geräts registriert hat, empfängt die Rückruffunktion jede E/A-Anforderung aus der Warteschlange, es sei denn, anforderungsspezifische Rückruffunktionen wurden ebenfalls registriert. Weitere Informationen zu anforderungsspezifischen Rückruffunktionen finden Sie unter Anforderungshandler.

Die EvtIoDefault-Rückruffunktion eines Treibers kann auch Dateierstellungsanforderungen empfangen. Weitere Informationen zum Empfangen von Dateierstellungsanforderungen finden Sie unter Frameworkdateiobjekte.

Die EvtIoDefault-Rückruffunktion muss jede empfangene E/A-Anforderung in irgendeiner Weise verarbeiten. Weitere Informationen finden Sie unter Verarbeiten von E/A-Anforderungen.

Die meisten E/A-Vorgänge erfordern einen Eingabepuffer, einen Ausgabepuffer oder beides. Informationen dazu, wie der Treiber auf die Puffer einer Anforderung zugreifen kann, finden Sie unter Zugreifen auf Datenpuffer in Framework-Based Treibern.

Diese Rückruffunktion kann unter IRQL <= DISPATCH_LEVEL aufgerufen werden, es sei denn, das ExecutionLevel-Element der WDF_OBJECT_ATTRIBUTES Struktur des Geräts oder Treibers ist auf WdfExecutionLevelPassive festgelegt.

Wenn der IRQL PASSIVE_LEVEL ist, ruft das Framework die Rückruffunktion in einem kritischen Bereich auf.

Weitere Informationen zu IRQL-Ebenen für Anforderungshandler finden Sie unter Verwenden der automatischen Synchronisierung.

Die EvtIoDefault-Rückruffunktion eines Treibers sollte die folgenden Warteschlangenobjektmethoden nicht aufrufen:

WdfIoQueueDrainSynchronly

WdfIoQueuePurgeSynchronly

WdfIoQueueStopSynchronous

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)