WDF_CHILD_RETRIEVE_INFO 结构 (wdfchildlist.h)

项目
02/26/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，则不使用此指针。