wdfchildlist.h 标头

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

• Windows Driver Framework

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 之前可以设置的标志。