共用方式為


WDF_CHILD_RETRIEVE_INFO 結構 (wdfchildlist.h)

[僅適用於 KMDF]

WDF_CHILD_RETRIEVE_INFO 結構包含透過呼叫 WdfChildListRetrieveNextDeviceWdfChildListRetrievePdo 取得之子裝置的相關信息。

語法

typedef struct _WDF_CHILD_RETRIEVE_INFO {
  ULONG                                                 Size;
  PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER          IdentificationDescription;
  PWDF_CHILD_ADDRESS_DESCRIPTION_HEADER                 AddressDescription;
  WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS                 Status;
  PFN_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_COMPARE EvtChildListIdentificationDescriptionCompare;
} WDF_CHILD_RETRIEVE_INFO, *PWDF_CHILD_RETRIEVE_INFO;

成員

Size

這個結構的大小,以位元組為單位。

IdentificationDescription

驅動程式配置的 WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER 結構的指標。 驅動程式必須提供這個結構的 IdentificationDescriptionSize 成員的值。

如果驅動程式呼叫 WdfChildListRetrieveNextDevice 並提供 EvtChildListIdentificationDescriptionCompare 回呼函式,則驅動程式也必須提供回呼函式可用來與子清單中的項目比較的 識別描述

如果驅動程式呼叫 WdfChildListRetrievePdo,驅動程式必須填入整個識別描述。

AddressDescription

驅動程式配置的 WDF_CHILD_ADDRESS_DESCRIPTION_HEADER 結構的指標。 驅動程式必須為此結構的 AddressDescriptionSize 成員提供值。 架構會在從子清單中擷取子系時填入其餘位址 描述 。 如果 AddressDescriptionSize 的值是 NULL,則不會擷取位址描述資訊。

Status

架構提供的 WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS型別值。

EvtChildListIdentificationDescriptionCompare

驅動程式提供的 EvtChildListIdentificationDescriptionCompare 回呼函式的指標。

如果驅動程式呼叫 WdfChildListRetrieveNextDevice,此指標是選擇性的,而且可以是 NULL

如果驅動程式呼叫 WdfChildListRetrievePdo,則不會使用此指標。

備註

WDF_CHILD_RETRIEVE_INFO 結構會傳遞至 WdfChildListRetrieveNextDeviceWdfChildListRetrievePdo 方法。

若要初始化WDF_CHILD_RETRIEVE_INFO結構,驅動程式必須呼叫 WDF_CHILD_RETRIEVE_INFO_INIT

規格需求

需求
最小 KMDF 版本 1.0
標頭 wdfchildlist.h (包含 Wdf.h)

另請參閱

EvtChildListIdentificationDescriptionCompare

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER

WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS

WdfChildListRetrieveNextDevice

WdfChildListRetrievePdo