共用方式為

WdfPdoRetrieveAddressDescription 函式 （wdfpdo.h）

  • 發行項

[僅適用於 KMDF]

WdfPdoRetrieveAddressDescription 方法會擷取與指定架構裝置對象相關聯的 位址描述。

語法

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

參數

[in] Device

架構裝置物件的句柄，表示裝置的實體裝置物件 （PDO）。

[in, out] AddressDescription

將接收位址描述之呼叫端配置的緩衝區指標。 位址描述必須包含 WDF_CHILD_ADDRESS_DESCRIPTION_HEADER 結構。

返回值

如果作業成功，函式會傳回STATUS_SUCCESS。 其他傳回值包括：

回傳碼 說明
STATUS_INVALID_PARAMETER
 裝置 句柄不代表 PDO。
STATUS_INVALID_DEVICE_REQUEST
 裝置 句柄不代表動態列舉 的裝置。
 

方法也可能 傳回其他NTSTATUS 值。

如果驅動程式提供無效的物件句柄，就會發生系統錯誤檢查。

需求

要求 價值
目標平臺 普遍
最低 KMDF 版本 1.0
標題 wdfpdo.h （包括 Wdf.h）
程式庫 Wdf01000.sys （請參閱架構連結庫版本控制。）
IRQL <= DISPATCH_LEVEL
DDI 合規性規則 DriverCreate（kmdf），KmdfIrql（kmdf），KmdfIrql2（kmdf），KmdfIrqlExplicit（kmdf）

另請參閱

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER_INIT

WdfChildListRetrieveAddressDescription

WdfPdoRetrieveIdentificationDescription