WdfDeviceInitSetIoType-Funktion (wdfdevice.h)
[Gilt für KMDF und UMDF]
Die WdfDeviceInitSetIoType--Methode legt die Methode oder Einstellung fest, wie ein Treiber auf die In Lese- und Schreibanforderungen für ein bestimmtes Gerät enthaltenen Datenpuffer zugreift.
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-typed-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
Nichts
Bemerkungen
KMDF-Wenn Sie einen neuen Treiber mit KMDF Version 1.13 oder höher schreiben, sollten Sie stattdessen WdfDeviceInitSetIoTypeExverwenden. Das Aufrufen WdfDeviceInitSetIoType von einem KMDF-Filtertreiber hat keine Auswirkung. Für Filtertreiber verwendet das Framework den vom nächsten niedrigeren Treiber im Treiberstapel angegebenen E/A-Typ.
UMDF-Wenn Sie einen KMDF-Treiber konvertieren, der WdfDeviceInitSetIoType in UMDF Version 2.0 oder höher aufruft, kann Ihr konvertierter Treiber weiterhin WdfDeviceInitSetIoType aufrufen. Wenn Sie jedoch einen völlig neuen Treiber mit UMDF Version 2.0 oder höher schreiben, sollten Sie stattdessen WdfDeviceInitSetIoTypeExverwenden.
Wenn ein Treiber WdfDeviceInitSetIoTypeaufruft, muss er dies tun, bevor er WdfDeviceCreateaufruft. Weitere Informationen zum Aufrufen WdfDeviceCreatefinden Sie unter Creating a Framework Device Object.
Wenn der Treiber nicht WdfDeviceInitSetIoTypeaufruft, legt das Framework die Pufferzugriffsmethode des Treibers auf WdfDeviceIoBufferedfür das angegebene Gerät fest.
Weitere Informationen zu Pufferzugriffsmethoden finden Sie unter Zugreifen auf Datenpuffer.
Beispiele
Im folgenden Codebeispiel wird angegeben, dass ein Treiber die direkte E/A-Methode verwendet, wenn er auf das Gerät zugreift.
WdfDeviceInitSetIoType(
DeviceInit,
WdfDeviceIoDirect
);
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Minimale KMDF-Version | 1.0 |
| Mindest-UMDF-Version | 2.0 |
| Header- | wdfdevice.h (einschließen Wdf.h) |
| Library | 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) |