WdfPdoRetrieveIdentificationDescription 函式 (wdfpdo.h)

  • 發行項

[僅適用於 KMDF]

WdfPdoRetrieveIdentificationDescription 方法會擷取與指定架構裝置對象相關聯的識別描述。

語法

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

參數

[in] Device

架構裝置物件的句柄，代表裝置的實體裝置物件 (PDO) 。

[in, out] IdentificationDescription

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

傳回值

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

傳回碼 Description
STATUS_INVALID_PARAMETER
 裝置句柄不代表 PDO。
STATUS_INVALID_DEVICE_REQUEST
 裝置句柄不代表動態列舉的裝置，或如果WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER結構未包含正確的緩衝區大小，則為 。
 

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

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

規格需求

需求 值
目標平台 Universal
最低 KMDF 版本 1.0
標頭 wdfpdo.h (包含 Wdf.h)
程式庫 Wdf01000.sys (請參閱 Framework Library Versioning.)
IRQL <= DISPATCH_LEVEL
DDI 合規性規則 DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf)

另請參閱

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT

WdfPdoRetrieveAddressDescription