WDF_CHILD_LIST_CONFIG 结构 (wdfchildlist.h)

[仅适用于 KMDF]

WDF_CHILD_LIST_CONFIG 结构包含子设备列表的配置信息。

语法

typedef struct _WDF_CHILD_LIST_CONFIG {
  ULONG                                                   Size;
  ULONG                                                   IdentificationDescriptionSize;
  ULONG                                                   AddressDescriptionSize;
  PFN_WDF_CHILD_LIST_CREATE_DEVICE                        EvtChildListCreateDevice;
  PFN_WDF_CHILD_LIST_SCAN_FOR_CHILDREN                    EvtChildListScanForChildren;
  PFN_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_COPY      EvtChildListIdentificationDescriptionCopy;
  PFN_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_DUPLICATE EvtChildListIdentificationDescriptionDuplicate;
  PFN_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_CLEANUP   EvtChildListIdentificationDescriptionCleanup;
  PFN_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_COMPARE   EvtChildListIdentificationDescriptionCompare;
  PFN_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_COPY             EvtChildListAddressDescriptionCopy;
  PFN_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_DUPLICATE        EvtChildListAddressDescriptionDuplicate;
  PFN_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_CLEANUP          EvtChildListAddressDescriptionCleanup;
  PFN_WDF_CHILD_LIST_DEVICE_REENUMERATED                  EvtChildListDeviceReenumerated;
} WDF_CHILD_LIST_CONFIG, *PWDF_CHILD_LIST_CONFIG;

成员

Size

此结构的大小(以字节为单位)。

IdentificationDescriptionSize

每个子项 的标识说明的大小(以字节为单位)。 有关详细信息,请参阅 WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER

AddressDescriptionSize

每个子级 地址说明的大小(以字节为单位)。 有关详细信息,请参阅 WDF_CHILD_ADDRESS_DESCRIPTION_HEADER

EvtChildListCreateDevice

指向驱动程序的 EvtChildListCreateDevice 事件回调函数的指针。 此回调函数是必需的。

EvtChildListScanForChildren

指向驱动程序的 EvtChildListScanForChildren 事件回调函数的指针。 此回调函数是可选的。

EvtChildListIdentificationDescriptionCopy

指向驱动程序的 EvtChildListIdentificationDescriptionCopy 事件回调函数的指针。 此回调函数是可选的。

EvtChildListIdentificationDescriptionDuplicate

指向驱动程序的 EvtChildListIdentificationDescriptionDuplicate 事件回调函数的指针。 此回调函数是可选的。

EvtChildListIdentificationDescriptionCleanup

指向驱动程序的 EvtChildListIdentificationDescriptionCleanup 事件回调函数的指针。 此回调函数是可选的。

EvtChildListIdentificationDescriptionCompare

指向驱动程序的 EvtChildListIdentificationDescriptionCompare 事件回调函数的指针。 此回调函数是可选的。

EvtChildListAddressDescriptionCopy

指向驱动程序的 EvtChildListAddressDescriptionCopy 事件回调函数的指针。 此回调函数是可选的。

EvtChildListAddressDescriptionDuplicate

指向驱动程序的 EvtChildListAddressDescriptionDuplicate 事件回调函数的指针。 此回调函数是可选的。

EvtChildListAddressDescriptionCleanup

指向驱动程序的 EvtChildListAddressDescriptionCleanup 事件回调函数的指针。 此回调函数是可选的。

EvtChildListDeviceReenumerated

指向驱动程序的 EvtChildListDeviceReenumerated 事件回调函数的指针。 此回调函数是可选的。

注解

WDF_CHILD_LIST_CONFIG 结构用作 WdfFdoInitSetDefaultChildListConfigWdfChildListCreate 方法的输入。

若要初始化WDF_CHILD_LIST_CONFIG结构,驱动程序必须调用 WDF_CHILD_LIST_CONFIG_INIT

有关子列表的详细信息,请参阅 动态枚举

要求

要求
最低 KMDF 版本 1.0
标头 wdfchildlist.h (包括 Wdf.h)

另请参阅

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER

WDF_CHILD_LIST_CONFIG_INIT

WdfChildListCreate

WdfFdoInitSetDefaultChildListConfig