struktur WDF_IO_TYPE_CONFIG (wdfdevice.h)

[Berlaku untuk KMDF dan UMDF]

Struktur WDF_IO_TYPE_CONFIG menentukan metode akses buffer pilihan driver untuk permintaan baca dan tulis, dan untuk permintaan kontrol I/O perangkat.

Sintaks

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;

Anggota

Size

Ukuran struktur ini dalam byte.

ReadWriteIoType

KMDF Enumerator jenis WDF_DEVICE_IO_TYPE yang mengidentifikasi metode yang akan digunakan driver untuk mengakses buffer data yang diterimanya untuk permintaan baca dan tulis.

UMDF Enumerator yang diketik WDF_DEVICE_IO_TYPE yang mengidentifikasi metode yang Anda gunakan driver untuk mengakses buffer data permintaan baca dan tulis. Nilai yang valid termasuk WdfDeviceIoBuffered dan WdfDeviceIoDirect.

DeviceControlIoType

Anggota ini tidak berlaku untuk KMDF.

UMDF Enumerator jenis WDF_DEVICE_IO_TYPE yang mengidentifikasi metode yang Anda sukai penggunaan driver untuk buffer data permintaan IOCTL. Nilai yang valid termasuk WdfDeviceIoBuffered dan WdfDeviceIoDirect.

DirectTransferThreshold

Anggota ini tidak berlaku untuk KMDF.

UMDF Nilai opsional yang menentukan ukuran buffer terkecil, dalam byte, yang kerangka kerjanya akan menggunakan I/O langsung untuk perangkat. Misalnya, atur DirectTransferThreshold ke 12288 untuk menunjukkan bahwa kerangka kerja harus menggunakan I/O buffer untuk semua buffer yang lebih kecil dari 12 kilobyte, dan I/O langsung untuk buffer yang sama dengan atau lebih besar dari 12 kilobyte. Biasanya, Anda tidak perlu memberikan nilai ini karena kerangka kerja menggunakan pengaturan yang memberikan performa terbaik.

Keterangan

Struktur WDF_IO_TYPE_CONFIG digunakan sebagai input ke metode WdfDeviceInitSetIoTypeEx .

Untuk menginisialisasi struktur WDF_IO_TYPE_CONFIG , driver Anda harus memanggil WDF_IO_TYPE_CONFIG_INIT.

Jika Anda menulis driver menggunakan UMDF versi 2.0 atau yang lebih baru, lihat Mengelola Metode Akses Buffer di Driver UMDF untuk informasi selengkapnya tentang menentukan metode akses buffer pilihan.

Jika Anda menulis driver menggunakan UMDF versi 1. x, driver Anda memanggil IWDFDeviceInitialize2::SetIoTypePreference untuk menentukan metode akses buffer pilihan.

Persyaratan

Persyaratan	Nilai
Versi KMDF minimum	1.13
Versi UMDF minimum	2.0
Header	wdfdevice.h (termasuk Wdf.h)

Lihat juga

WDF_DEVICE_IO_TYPE

WDF_IO_TYPE_CONFIG_INIT

WdfDeviceInitSetIoTypeEx