Bagikan melalui


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
STATUS_INVALID_DEVICE_REQUEST
Driver menginisialisasi FDO alih-alih PDO.
STATUS_INSUFFICIENT_RESOURCES
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)

Lihat juga

RtlInitUnicodeString

WdfPdoInitAddCompatibleID

WdfPdoInitAddHardwareID

WdfPdoInitAssignDeviceID

WdfPdoInitAssignInstanceID