WdfDeviceInitSetIoType-Funktion (wdfdevice.h)
[Gilt für KMDF und UMDF]
Die WdfDeviceInitSetIoType-Methode legt die Methode oder Einstellung für den Zugriff eines Treibers auf die Datenpuffer fest, die in Lese- und Schreibanforderungen für ein angegebenes Gerät enthalten sind.
Syntax
void WdfDeviceInitSetIoType(
[in] PWDFDEVICE_INIT DeviceInit,
[in] WDF_DEVICE_IO_TYPE IoType
);
Parameter
[in] DeviceInit
Ein Zeiger auf eine WDFDEVICE_INIT-Struktur .
[in] IoType
Ein WDF_DEVICE_IO_TYPE typisierter Enumerator, der die Methode identifiziert, die der Treiber für den Zugriff auf Datenpuffer verwendet, die er für Lese- und Schreibanforderungen empfängt.
Rückgabewert
Keine
Bemerkungen
KMDF Wenn Sie einen neuen Treiber mit KMDF-Version 1.13 oder höher schreiben, sollten Sie stattdessen WdfDeviceInitSetIoTypeEx verwenden. Das Aufrufen von WdfDeviceInitSetIoType von einem KMDF-Filtertreiber hat keine Auswirkungen. Für Filtertreiber verwendet das Framework den E/A-Typ, der vom nächstniedrigen Treiber im Treiberstapel angegeben wird.
UMDF Wenn Sie einen KMDF-Treiber konvertieren, der WdfDeviceInitSetIoType aufruft, in UMDF-Version 2.0 oder höher, kann Ihr konvertierter Treiber WdfDeviceInitSetIoType weiterhin ohne Probleme aufrufen. Wenn Sie jedoch einen völlig neuen Treiber mit UMDF-Version 2.0 oder höher schreiben, sollten Sie stattdessen WdfDeviceInitSetIoTypeEx verwenden.
Wenn ein Treiber WdfDeviceInitSetIoType aufruft, muss er dies tun, bevor er WdfDeviceCreate aufruft. Weitere Informationen zum Aufrufen von WdfDeviceCreate finden Sie unter Erstellen eines Framework-Geräteobjekts.
Wenn der Treiber WdfDeviceInitSetIoType nicht aufruft, legt das Framework die Pufferzugriffsmethode des Treibers für das angegebene Gerät auf WdfDeviceIoBuffered fest.
Weitere Informationen zu Pufferzugriffsmethoden finden Sie unter Zugreifen auf Datenpuffer.
Beispiele
Das folgende Codebeispiel gibt an, dass ein Treiber die direkte E/A-Methode verwendet, wenn er auf das Gerät zugreift.
WdfDeviceInitSetIoType(
DeviceInit,
WdfDeviceIoDirect
);
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| UMDF-Mindestversion | 2.0 |
| Kopfzeile | wdfdevice.h (einschließen von Wdf.h) |
| Bibliothek | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf) |