EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_CLEANUP回调函数 (wdfchildlist.h)
[仅适用于 KMDF]
驱动程序的 EvtChildListIdentificationDescriptionCleanup 事件回调函数为 驱动程序的 EvtChildListIdentificationDescriptionDuplicate 回调函数分配的标识说明释放任何内存分配。
语法
EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_CLEANUP EvtWdfChildListIdentificationDescriptionCleanup;
void EvtWdfChildListIdentificationDescriptionCleanup(
[in] WDFCHILDLIST ChildList,
[in, out] PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription
)
{...}
参数
[in] ChildList
框架子列表对象的句柄。
[in, out] IdentificationDescription
指向标识说明 WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER 结构的指针。
返回值
无
备注
如果总线驱动程序正在使用动态枚举,它可以通过调用 WdfFdoInitSetDefaultChildListConfig 或 WdfChildListCreate 来注册 EvtChildListIdentificationDescriptionCleanup 回调函数。
如果标识说明指向存储在动态分配的内存中的其他信息,并且该内存由 EvtChildListIdentificationDescriptionDuplicate 回调函数分配,则驱动程序必须提供 EvtChildListIdentificationDescriptionCleanup 回调函数。
通常, EvtChildListIdentificationDescriptionDuplicate 回调函数通过调用 ExAllocatePool 来分配内存。 EvtChildListIdentificationDescriptionCleanup 回调函数必须通过调用 ExFreePool 解除分配该内存。 此回调函数不得尝试解除分配标识说明的其余部分。 换句话说,回调函数不得解除分配 IdentificationDescription 参数指向的地址说明结构;它必须仅解除分配说明结构指向的其他内存分配。
有关动态枚举的详细信息,请参阅 枚举总线上的设备。
要求
要求 | 值 |
---|---|
目标平台 | 通用 |
最低 KMDF 版本 | 1.0 |
标头 | wdfchildlist.h (包括 Wdf.h) |
IRQL | <= DISPATCH_LEVEL |
另请参阅
EvtChildListIdentificationDescriptionDuplicate