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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk