Fungsi WdfPdoRetrieveIdentificationDescription (wdfpdo.h)

  • Artikel

[Berlaku untuk KMDF saja]

Metode WdfPdoRetrieveIdentificationDescription mengambil deskripsi identifikasi yang terkait dengan objek perangkat kerangka kerja tertentu.

Sintaks

NTSTATUS WdfPdoRetrieveIdentificationDescription(
  [in]      WDFDEVICE                                    Device,
  [in, out] PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription
);

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja yang mewakili objek perangkat fisik (PDO) perangkat.

[in, out] IdentificationDescription

Penunjuk ke buffer yang dialokasikan penelepon yang akan menerima deskripsi identifikasi. Deskripsi identifikasi harus berisi struktur WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER .

Nilai kembali

Jika operasi berhasil, fungsi akan mengembalikan STATUS_SUCCESS. Nilai pengembalian tambahan meliputi:

Menampilkan kode Deskripsi
STATUS_INVALID_PARAMETER
 Handel Perangkat tidak mewakili PDO.
STATUS_INVALID_DEVICE_REQUEST
 Handel Perangkat tidak mewakili perangkat yang dijumlahkan secara dinamis, atau jika struktur WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER tidak berisi ukuran buffer yang benar.
 

Metode ini mungkin juga mengembalikan nilai NTSTATUS lainnya.

Pemeriksaan bug sistem terjadi jika driver memasok handel objek yang tidak valid.

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 <= DISPATCH_LEVEL
Aturan kepatuhan DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Lihat juga

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT

WdfPdoRetrieveAddressDescription