WDF_CHILD_RETRIEVE_INFO 結構 (wdfchildlist.h)

發行項
02/27/2024

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