Fungsi WdfPdoUpdateAddressDescription (wdfpdo.h)

  • Artikel

[Berlaku untuk KMDF saja]

Metode WdfPdoUpdateAddressDescription memperbarui deskripsi alamat yang terkait dengan objek perangkat kerangka kerja tertentu.

Sintaks

NTSTATUS WdfPdoUpdateAddressDescription(
  [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 berisi 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, atau jika anggota Ukuran dari struktur WDF_CHILD_ADDRESS_DESCRIPTION_HEADER yang ditentukan tidak cocok dengan ukuran deskripsi alamat perangkat yang ada.
 

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

WdfPdoRetrieveAddressDescription