Bagikan melalui


Fungsi WdfDeviceInitSetIoType (wdfdevice.h)

[Berlaku untuk KMDF dan UMDF]

Metode WdfDeviceInitSetIoType mengatur metode atau preferensi tentang bagaimana driver akan mengakses buffer data yang disertakan dalam permintaan baca dan tulis untuk perangkat tertentu.

Sintaks

void WdfDeviceInitSetIoType(
  [in] PWDFDEVICE_INIT    DeviceInit,
  [in] WDF_DEVICE_IO_TYPE IoType
);

Parameter

[in] DeviceInit

Penunjuk ke struktur WDFDEVICE_INIT .

[in] IoType

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

Nilai kembali

Tidak ada

Keterangan

KMDF Jika Anda menulis driver baru menggunakan KMDF versi 1.13 atau yang lebih baru, Anda harus menggunakan WdfDeviceInitSetIoTypeEx. Memanggil WdfDeviceInitSetIoType dari driver filter KMDF tidak berpengaruh. Untuk driver filter, kerangka kerja menggunakan jenis I/O yang ditentukan oleh driver berikutnya yang lebih rendah di tumpukan driver.

UMDF Jika Anda mengonversi driver KMDF yang memanggil WdfDeviceInitSetIoType ke UMDF versi 2.0 atau yang lebih baru, driver anda yang dikonversi dapat terus memanggil WdfDeviceInitSetIoType tanpa masalah. Namun, jika Anda menulis driver yang sama sekali baru menggunakan UMDF versi 2.0 atau yang lebih baru, Anda harus menggunakan WdfDeviceInitSetIoTypeEx.

Jika driver memanggil WdfDeviceInitSetIoType, driver harus melakukannya sebelum memanggil WdfDeviceCreate. Untuk informasi selengkapnya tentang memanggil WdfDeviceCreate, lihat Membuat Objek Perangkat Kerangka Kerja.

Jika driver tidak memanggil WdfDeviceInitSetIoType, kerangka kerja mengatur metode akses buffer driver ke WdfDeviceIoBuffered, untuk perangkat yang ditentukan.

Untuk informasi selengkapnya tentang metode akses buffer, lihat Mengakses Buffer Data.

Contoh

Contoh kode berikut menunjukkan bahwa driver akan menggunakan metode I/O langsung saat mengakses perangkat.

WdfDeviceInitSetIoType(
                       DeviceInit,
                       WdfDeviceIoDirect
                       );

Persyaratan

Persyaratan Nilai
Target Platform Universal
Versi KMDF minimum 1,0
Versi UMDF minimum 2.0
Header wdfdevice.h (termasuk Wdf.h)
Pustaka Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
Aturan kepatuhan DDI ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

Lihat juga

IWDFDeviceInitialize2::SetIoTypePreference

WDF_DEVICE_IO_TYPE

WdfDeviceInitSetIoTypeEx