EVT_WDF_IO_QUEUE_IO_DEFAULT Rückruffunktion (wdfio.h)
[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:
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) |