Fungsi WdfPdoInitAssignRawDevice (wdfpdo.h)
[Hanya berlaku untuk KMDF]
Metode WdfPdoInitAssignRawDevice menunjukkan bahwa driver panggilan dapat mendukung perangkat tertentu dalam mode mentah.
Sintaks
NTSTATUS WdfPdoInitAssignRawDevice(
[in] PWDFDEVICE_INIT DeviceInit,
[in] const GUID *DeviceClassGuid
);
Parameter
[in] DeviceInit
Penunjuk ke struktur WDFDEVICE_INIT .
[in] DeviceClassGuid
Penunjuk ke GUID yang mengidentifikasi kelas penyiapan perangkat.
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.
Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.
Nilai kembali
Jika operasi berhasil, metode mengembalikan STATUS_SUCCESS. Jika tidak, akan mengembalikan STATUS_INVALID_PARAMETER.
Keterangan
Driver harus memanggil WdfPdoInitAssignRawDevice sebelum memanggil WdfDeviceCreate. Untuk informasi selengkapnya tentang memanggil WdfDeviceCreate, lihat Membuat Objek Perangkat Kerangka Kerja.
Registri dapat berisi nilai yang mengambil alih nilai yang ditentukan driver saat memanggil WdfDeviceInitAssignSDDLString, WdfDeviceInitSetDeviceType, WdfDeviceInitSetCharacteristics, dan WdfDeviceInitSetExclusive. Parameter DeviceClassGuid metode WdfPdoInitAssignRawDevice menentukan GUID yang mengidentifikasi bagian registri yang berisi nilai penimpaan. Parameter DeviceClassGuid hanya mengidentifikasi bagian registri dan tidak benar-benar mengatur kelas penyiapan perangkat untuk perangkat. Bagian Versi INF di file INF perangkat dan driver Anda mengatur kelas penyiapan perangkat. Biasanya, GUID parameter DeviceClassGuid harus cocok dengan GUID yang ditentukan bagian Versi INF .
Untuk informasi selengkapnya tentang menggunakan registri, lihat Mengatur Properti Registri Objek Perangkat Setelah Penginstalan.
Contoh
Cuplikan berikut dari sampel driver kmdf_enumswitches menunjukkan bahwa driver dapat mendukung perangkat yang ditentukan dalam mode mentah.
NTSTATUS status;
DEFINE_GUID(GUID_DEVCLASS_MYUNIQUEID,
0xf149fe88, 0x f6cc, 0x47e3, 0x85, 0x94, 0xe2, 0xaa, 0xb6, 0xe0, 0x3b, 0xdf);
status = WdfPdoInitAssignRawDevice(
pDeviceInit,
&GUID_DEVCLASS_MYUNIQUEID
);
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Universal |
Versi KMDF minimum | 1,0 |
Header | wdfpdo.h (termasuk Wdf.h) |
Pustaka | Wdf01000.sys (lihat Penerapan Versi Pustaka Kerangka Kerja.) |
IRQL | PASSIVE_LEVEL |
Aturan kepatuhan DDI | ChildDeviceInitAPI(kmdf), DriverCreate(kmdf), InitFreeDeviceCallback(kmdf), InitFreeDeviceCreate(kmdf), InitFreeNull(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf), PdoInitFreeDeviceCallback(kmdf), PdoInitFreeDeviceCreate(kmdf) |