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)

Weitere Informationen

IWDFDeviceInitialize2::SetIoTypePreference

WDF_DEVICE_IO_TYPE

WdfDeviceInitSetIoTypeEx