WDF_IO_TYPE_CONFIG-Struktur (wdfdevice.h)

[Gilt für KMDF und UMDF]

Die WDF_IO_TYPE_CONFIG-Struktur gibt die bevorzugte Pufferzugriffsmethode des Treibers für Lese- und Schreibanforderungen sowie für Geräte-E/A-Steuerungsanforderungen an.

Syntax

typedef struct _WDF_IO_TYPE_CONFIG {
  ULONG              Size;
  WDF_DEVICE_IO_TYPE ReadWriteIoType;
  WDF_DEVICE_IO_TYPE DeviceControlIoType;
  ULONG              DirectTransferThreshold;
} WDF_IO_TYPE_CONFIG, *PWDF_IO_TYPE_CONFIG;

Member

Size

Größe dieser Struktur in Bytes.

ReadWriteIoType

KMDF Ein WDF_DEVICE_IO_TYPE typisiertes Enumerator, der die Methode identifiziert, die der Treiber für den Zugriff auf Datenpuffer verwendet, die er für Lese- und Schreibanforderungen empfängt.

UMDF Ein WDF_DEVICE_IO_TYPE typisierter Enumerator, der die Methode identifiziert, die der Treiber für den Zugriff auf Datenpuffer von Lese- und Schreibanforderungen bevorzugt. Gültige Werte sind WdfDeviceIoBuffered und WdfDeviceIoDirect.

DeviceControlIoType

Dieser Member gilt nicht für KMDF.

UMDF Ein WDF_DEVICE_IO_TYPE typisierter Enumerator, der die Methode identifiziert, die der Treiber für die Datenpuffer von IOCTL-Anforderungen bevorzugt. Gültige Werte sind WdfDeviceIoBuffered und WdfDeviceIoDirect.

DirectTransferThreshold

Dieser Member gilt nicht für KMDF.

UMDF Ein optionaler Wert, der die kleinste Puffergröße in Bytes angibt, für die das Framework direkte E/A für ein Gerät verwendet. Legen Sie beispielsweise DirectTransferThreshold auf 12288 fest, um anzugeben, dass das Framework gepufferte E/A für alle Puffer verwenden soll, die kleiner als 12 KB sind, und direkte E/A für Puffer, die gleich oder größer als 12 KB sind. In der Regel müssen Sie diesen Wert nicht angeben, da das Framework Einstellungen verwendet, die die beste Leistung bieten.

Hinweise

Die WDF_IO_TYPE_CONFIG-Struktur wird als Eingabe für die WdfDeviceInitSetIoTypeEx-Methode verwendet.

Um eine WDF_IO_TYPE_CONFIG-Struktur zu initialisieren, sollte Ihr Treiber WDF_IO_TYPE_CONFIG_INIT aufrufen.

Wenn Sie einen Treiber mit UMDF Version 2.0 oder höher schreiben, finden Sie weitere Informationen zum Angeben bevorzugter Pufferzugriffsmethoden unter Verwalten von Pufferzugriffsmethoden in UMDF-Treibern .

Wenn Sie einen Treiber mit UMDF Version 1 schreiben. x, ruft Ihr Treiber IWDFDeviceInitialize2::SetIoTypePreference auf, um bevorzugte Pufferzugriffsmethoden anzugeben.

Anforderungen

Anforderung	Wert
KMDF-Mindestversion	1.13
UMDF-Mindestversion	2.0
Kopfzeile	wdfdevice.h (einschließen von Wdf.h)

Weitere Informationen

WDF_DEVICE_IO_TYPE

WDF_IO_TYPE_CONFIG_INIT

WdfDeviceInitSetIoTypeEx