EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_CLEANUP回调函数 (wdfchildlist.h)

项目
09/24/2022

[仅适用于 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 参数指向的地址说明结构：它必须只释放描述结构指向的其他内存分配。

有关动态枚举的详细信息，请参阅枚举总线上的设备。