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)

Lihat juga

WdfDeviceGetCharacteristics

WdfDeviceInitSetCharacteristics