wdfchildlist.h header

wdf 使用此标头。 有关详细信息，请参阅：

• Windows 驱动程序框架

wdfchildlist.h 包含以下编程接口：

函数

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER_INIT WDF_CHILD_ADDRESS_DESCRIPTION_HEADER_INIT 函数初始化WDF_CHILD_ADDRESS_DESCRIPTION_HEADER 结构。
WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT 函数初始化WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER 结构。
WDF_CHILD_LIST_CONFIG_INIT WDF_CHILD_LIST_CONFIG_INIT 函数初始化WDF_CHILD_LIST_CONFIG 结构。
WDF_CHILD_LIST_ITERATOR_INIT WDF_CHILD_LIST_ITERATOR_INIT 函数初始化WDF_CHILD_LIST_ITERATOR 结构。
WDF_CHILD_RETRIEVE_INFO_INIT WDF_CHILD_RETRIEVE_INFO_INIT 函数初始化WDF_CHILD_RETRIEVE_INFO 结构。
WdfChildListAddOrUpdateChildDescriptionAsPresent WdfChildListAddOrUpdateChildDescriptionAsPresent 方法将新的子描述添加到子级列表或更新现有的子说明。
WdfChildListBeginIteration WdfChildListBeginIteration 方法为检索指定子列表中的项准备框架。
WdfChildListBeginScan WdfChildListBeginScan 方法准备指定的子设备列表，以便驱动程序可以更新列表中的信息。
WdfChildListCreate WdfChildListCreate 方法为指定的父设备创建子列表。
WdfChildListEndIteration WdfChildListEndIteration 方法处理对指定子列表的修改。
WdfChildListEndScan WdfChildListEndScan 方法处理对指定子列表的修改。
WdfChildListGetDevice WdfChildListGetDevice 方法返回表示指定子列表的父设备的框架设备对象的句柄。
WdfChildListRequestChildEject WdfChildListRequestChildEject 方法通知框架指定的设备即将从其扩展坞中弹出。
WdfChildListRetrieveAddressDescription WdfChildListRetrieveAddressDescription 方法查找具有指定标识说明的子设备，并检索设备的地址说明。
WdfChildListRetrieveNextDevice WdfChildListRetrieveNextDevice 方法遍历指定的子列表，并检索与指定条件匹配的下一个子设备。
WdfChildListRetrievePdo WdfChildListRetrievePdo 方法返回框架设备对象的句柄，该句柄与子列表中的指定子说明相关联。
WdfChildListUpdateAllChildDescriptionsAsPresent WdfChildListUpdateAllChildDescriptionsAsPresent 方法通知框架指定子列表中的所有子设备已插入并可用。
WdfChildListUpdateChildDescriptionAsMissing WdfChildListUpdateChildDescriptionAsMissing 方法通知框架指定的子设备当前已拔出或不可用。

回调函数

EVT_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_CLEANUP 驱动程序的 EvtChildListAddressDescriptionCleanup 事件回调函数为驱动程序的 EvtChildListAddressDescriptionDuplicate 回调函数分配的地址说明释放所有内存分配。
EVT_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_COPY 驱动程序的 EvtChildListAddressDescriptionCopy 事件回调函数将子地址说明从一个指定位置复制到另一个指定位置。
EVT_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_DUPLICATE 驱动程序的 EvtChildListAddressDescriptionDuplicate 事件回调函数复制子地址说明。
EVT_WDF_CHILD_LIST_CREATE_DEVICE 总线驱动程序的EvtChildListCreateDevice 事件回调函数为已动态枚举的新设备创建框架设备对象。
EVT_WDF_CHILD_LIST_DEVICE_REENUMERATED 驱动程序的 EvtChildListDeviceReenumerated 事件回调函数使驱动程序能够批准或取消指定设备的恢复。
EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_CLEANUP 驱动程序的 EvtChildListIdentificationDescriptionCleanup 事件回调函数为驱动程序的 EvtChildListIdentificationDescriptionDuplicate 回调函数分配的标识说明释放任何内存分配。
EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_COMPARE 驱动程序的 EvtChildListIdentificationDescriptionCompare 事件回调函数将一个子标识说明与另一个子标识说明进行比较。
EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_COPY 驱动程序的 EvtChildListIdentificationDescriptionCopy 事件回调函数将子标识说明从一个指定位置复制到另一个指定位置。
EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_DUPLICATE 驱动程序的 EvtChildListIdentificationDescriptionDuplicate 事件回调函数复制子标识说明。
EVT_WDF_CHILD_LIST_SCAN_FOR_CHILDREN 驱动程序的 EvtChildListScanForChildren 事件回调函数必须报告存在的所有子设备。

结构

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER WDF_CHILD_ADDRESS_DESCRIPTION_HEADER 结构是标头结构，必须是每个地址说明结构的第一个成员。
WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER 结构是标头结构，必须是每个标识说明结构的第一个成员。
WDF_CHILD_LIST_CONFIG WDF_CHILD_LIST_CONFIG 结构包含子设备列表的配置信息。
WDF_CHILD_LIST_ITERATOR WDF_CHILD_LIST_ITERATOR 结构标识当驱动程序调用 WdfChildListRetrieveNextDevice 时框架将检索的子设备类型。
WDF_CHILD_RETRIEVE_INFO WDF_CHILD_RETRIEVE_INFO 结构包含有关通过调用 WdfChildListRetrieveNextDevice 或 WdfChildListRetrievePdo 获取的子设备的信息。

枚举

WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS 枚举定义框架存储在驱动程序WDF_CHILD_RETRIEVE_INFO结构中的设备状态值。
WDF_RETRIEVE_CHILD_FLAGS WDF_RETRIEVE_CHILD_FLAGS枚举定义驱动程序在调用 WdfChildListBeginIteration 之前可以设置的标志。