Fungsi WdfDeviceInitSetDeviceClass (wdfdevice.h)

Artikel
08/08/2023

[Hanya berlaku untuk KMDF]

Metode WdfDeviceInitSetDeviceClass menentukan GUID yang mengidentifikasi kelas penyiapan perangkat perangkat.

Sintaks

void WdfDeviceInitSetDeviceClass(
  [in] PWDFDEVICE_INIT DeviceInit,
  [in] const GUID      *DeviceClassGuid
);

Parameter

[in] DeviceInit

Penunjuk ke struktur WDFDEVICE_INIT .

[in] DeviceClassGuid

Penunjuk ke GUID yang mengidentifikasi bagian registri yang berisi kemungkinan penimpaan untuk parameter DefaultSDDLString, DeviceType, DeviceCharacteristics, dan Exclusive .

Catatan Anda harus selalu menentukan GUID kelas kustom. Anda tidak boleh menentukan GUID kelas yang ada. Jika Anda menentukan GUID kelas yang ada, driver lain yang mencoba menentukan bahwa GUID kelas yang ada mungkin gagal diinstal atau mungkin diinstal dengan pengaturan keamanan yang salah.

Nilai kembali

Tidak ada

Keterangan

Registri dapat berisi nilai yang mengambil alih nilai yang ditentukan driver saat memanggil WdfDeviceInitAssignSDDLString, WdfDeviceInitSetDeviceType, WdfDeviceInitSetCharacteristics, dan WdfDeviceInitSetExclusive. Driver dapat memanggil WdfDeviceInitSetDeviceClass untuk menentukan GUID yang mengidentifikasi bagian registri yang berisi nilai penimpaan.

Biasanya, driver memanggil WdfDeviceInitSetDeviceClass hanya jika membuat perangkat kontrol.

Untuk informasi selengkapnya tentang menggunakan registri, lihat Mengatur Properti Registri Objek Perangkat Setelah Penginstalan.

Jika driver memanggil WdfDeviceInitSetDeviceClass, driver harus melakukannya sebelum memanggil WdfDeviceCreate.

Untuk informasi selengkapnya tentang memanggil WdfDeviceCreate, lihat Membuat Objek Perangkat Kerangka Kerja.

Contoh

Contoh kode berikut mengatur kelas penyiapan perangkat ke kelas perangkat sistem.

DEFINE_GUID(GUID_DEVCLASS_MYUNIQUEID,
0xf149fe88, 0x f6cc, 0x47e3, 0x85, 0x94, 0xe2, 0xaa, 0xb6, 0xe0, 0x3b, 0xdf);

WdfDeviceInitSetDeviceClass(
                            DeviceInit,
                            &GUID_DEVCLASS_MYUNIQUEID
                            );

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)

Bagikan melalui