Fungsi WdfPdoInitAssignContainerID (wdfpdo.h)
[Berlaku untuk KMDF saja]
Metode WdfPdoInitAssignContainerID memperbarui ID kontainer untuk perangkat anak.
Sintaks
NTSTATUS WdfPdoInitAssignContainerID(
[in] PWDFDEVICE_INIT DeviceInit,
[in] PCUNICODE_STRING ContainerID
);
Parameter
[in] DeviceInit
Penunjuk ke struktur WDFDEVICE_INIT .
[in] ContainerID
Penunjuk ke struktur UNICODE_STRING yang berisi string ID kontainer. Driver dapat mengalokasikan buffer string dari kumpulan halaman.
Nilai kembali
Jika operasi berhasil, metode akan mengembalikan STATUS_SUCCESS. Nilai pengembalian tambahan meliputi:
Menampilkan kode | Deskripsi |
---|---|
|
Driver menginisialisasi FDO alih-alih PDO. |
|
Driver tidak dapat mengalokasikan ruang untuk menyimpan string ID kontainer. |
Metode ini mungkin juga mengembalikan nilai NTSTATUS lainnya.
Keterangan
Untuk informasi selengkapnya tentang ID kontainer, lihat String Identifikasi Perangkat.
Driver harus memanggil WdfPdoInitAssignContainerID sebelum memanggil WdfDeviceCreate. Untuk informasi selengkapnya tentang memanggil WdfDeviceCreate, lihat Membuat Objek Perangkat Kerangka Kerja.
Contoh
Contoh kode berikut menginisialisasi struktur UNICODE_STRING , menyimpan string Unicode dalam struktur, lalu mendaftarkan string Unicode sebagai ID kontainer perangkat.
UNICODE_STRING containerId = {0};
RtlInitUnicodeString(
&containerId,
strContainerId //Unicode string for container ID
);
status = WdfPdoInitAssignContainerID(
pDeviceInit,
&containerId
);
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Universal |
Versi KMDF minimum | 1.9 |
Header | wdfpdo.h (termasuk Wdf.h) |
Pustaka | Wdf01000.sys (lihat Penerapan Versi Pustaka Kerangka Kerja.) |
IRQL | PASSIVE_LEVEL |
Aturan kepatuhan DDI | DriverCreate(kmdf) |