Fungsi WdfPdoInitAssignRawDevice (wdfpdo.h)

  • Artikel

[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)

Lihat juga

WdfDeviceInitAssignSDDLString

WdfDeviceInitSetCharacteristics

WdfDeviceInitSetDeviceType

WdfDeviceInitSetExclusive