WDF_CHILD_RETRIEVE_INFO結構（wdfchildlist.h）

發行項
02/07/2025

[僅適用於 KMDF]

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

語法

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，則不會使用此指標。