Fungsi WdfPdoRetrieveAddressDescription (wdfpdo.h)

Artikel
02/29/2024

[Hanya berlaku untuk KMDF]

Metode WdfPdoRetrieveAddressDescription mengambil deskripsi alamat yang terkait dengan objek perangkat kerangka kerja tertentu.

Sintaks

NTSTATUS WdfPdoRetrieveAddressDescription(
  [in]      WDFDEVICE                             Device,
  [in, out] PWDF_CHILD_ADDRESS_DESCRIPTION_HEADER AddressDescription
);

Parameter

[in] Device

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

[in, out] AddressDescription

Penunjuk ke buffer yang dialokasikan penelepon yang akan menerima deskripsi alamat. Deskripsi alamat harus berisi struktur WDF_CHILD_ADDRESS_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.

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_ADDRESS_DESCRIPTION_HEADER_INIT

WdfChildListRetrieveAddressDescription

WdfPdoRetrieveIdentificationDescription

Bagikan melalui