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
)
{...}
Die Parameter
[in] Queue
Ein Handle für das Framework-Warteschlangenobjekt, das der E/A-Anforderung zugeordnet ist.
[in] Request
Ein Handle zu einem Framework-Anforderungsobjekt.
Rückgabewert
Nichts
Bemerkungen
Ein Treiber registriert eine EvtIoDefault- Rückruffunktion, wenn sie WdfIoQueueCreateaufruft. Weitere Informationen zum Aufrufen WdfIoQueueCreatefinden 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 Framework File Objects.
Die EvtIoDefault Rückruffunktion muss jede empfangene E/A-Anforderung auf irgendeine 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 Drivers.
Diese Rückruffunktion kann bei IRQL <= DISPATCH_LEVEL aufgerufen werden, es sei denn, das ExecutionLevel Mitglied der WDF_OBJECT_ATTRIBUTES Struktur des Geräts oder Treibers wird auf WdfExecutionLevelPassivefestgelegt.
Wenn die IRQL PASSIVE_LEVEL ist, ruft das Framework die Rückruffunktion innerhalb eines kritischen Bereichsauf.
Weitere Informationen zu IRQL-Ebenen für Anforderungshandler finden Sie unter Using Automatic Synchronization.
Die EvtIoDefault Rückruffunktion eines Treibers sollte nicht die folgenden Methoden des Warteschlangenobjekts aufrufen:
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") |