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)

Lihat juga

WdfDeviceSetCharacteristics