Fungsi WdfDeviceSetCharacteristics (wdfdevice.h)
[Berlaku untuk KMDF saja]
Metode WdfDeviceSetCharacteristics menetapkan karakteristik perangkat untuk perangkat tertentu.
Sintaks
void WdfDeviceSetCharacteristics(
[in] WDFDEVICE Device,
[in] ULONG DeviceCharacteristics
);
Parameter
[in] Device
Handel ke objek perangkat kerangka kerja.
[in] DeviceCharacteristics
Nilai yang terdiri dari konstanta yang ditentukan sistem ORed yang mewakili karakteristik perangkat. Untuk informasi selengkapnya, lihat Anggota karakteristik struktur DEVICE_OBJECT .
Nilai kembali
Tidak ada
Keterangan
Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.
Anda harus mengatur karakteristik perangkat dengan memanggil metode WdfDeviceInitSetCharacteristics di fungsi panggilan balik EvtDriverDeviceAdd Anda sebelum memanggil WdfDeviceCreate. Jika driver Anda tidak dapat menentukan karakteristik perangkat hingga setelah fungsi panggilan balik EvtDriverDeviceAdd kembali, driver biasanya harus memanggil WdfDeviceSetCharacteristics dalam fungsi panggilan balik EvtDevicePrepareHardware .
Setiap panggilan ke WdfDeviceSetCharacteristics menimpa pengaturan panggilan sebelumnya.
Contoh
Contoh kode berikut mengatur karakteristik FILE_REMOVABLE_MEDIA untuk perangkat tertentu.
WdfDeviceSetCharacteristics(
Device,
FILE_REMOVABLE_MEDIA
);
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Universal |
| Versi KMDF minimum | 1,0 |
| Header | wdfdevice.h (termasuk Wdf.h) |
| Pustaka | Wdf01000.sys (lihat Penerapan Versi Pustaka Kerangka Kerja.) |
| IRQL | <=DISPATCH_LEVEL |
| Aturan kepatuhan DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |