Fungsi WdfDeviceInitSetCharacteristics (wdfdevice.h)
[Hanya berlaku untuk KMDF]
Metode WdfDeviceInitSetCharacteristics menetapkan karakteristik perangkat untuk perangkat tertentu.
Sintaks
void WdfDeviceInitSetCharacteristics(
[in] PWDFDEVICE_INIT DeviceInit,
[in] ULONG DeviceCharacteristics,
[in] BOOLEAN OrInValues
);
Parameter
[in] DeviceInit
Penunjuk ke struktur WDFDEVICE_INIT .
[in] DeviceCharacteristics
Nilai yang terdiri dari konstanta yang ditentukan sistem ORed yang mewakili karakteristik perangkat. Untuk informasi selengkapnya, lihat Anggota karakteristik struktur DEVICE_OBJECT .
[in] OrInValues
Nilai Boolean. Jika nilai ini TRUE, nilai DeviceCharacteristics adalah ORed dengan karakteristik perangkat yang ada. Jika nilainya FALSE, nilai DeviceCharacteristics menggantikan karakteristik perangkat yang ada.
Mengembalikan nilai
Tidak ada
Keterangan
Untuk mengatur karakteristik perangkat, panggil 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, panggil WdfDeviceSetCharacteristics.
Untuk informasi selengkapnya tentang memanggil WdfDeviceCreate, lihat Membuat Objek Perangkat Kerangka Kerja.
Kerangka kerja selalu mengatur karakteristik FILE_DEVICE_SECURE_OPEN, sehingga driver Anda tidak perlu mengatur karakteristik ini.
Setiap panggilan ke WdfDeviceInitSetCharacteristics menimpa pengaturan panggilan sebelumnya.
Contoh
Contoh kode berikut menunjukkan bahwa perangkat adalah disket.
WdfDeviceInitSetCharacteristics(
DeviceInit,
FILE_FLOPPY_DISKETTE,
FALSE
);
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 | ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf) |