第11章 Windows线程池（3）_私有的线程池

参数

描述

PTP_CALLBACK_ENVIRON pcbe

清理组与线程池关联是通过这个结构体关联起来的（注意，这个结构中内部PTP_POOL字段指向了我们创建的线程池）

PTP_CLEANUP_GROUP ptpcg

指向由CreateThreadpoolCleanupGroup创建的清理 组。

PTP_CLEANUP_GROUP_CANCEL_CALLBACK pfng

CleanupGroupCancelCallback回调函数。当调用清理组CloseThreadpoolCleanupGroupmembers函数，并为bCancelPendingCallbacks传入TRUE来清除清理组时，如果此时尚有未被处理的工作项时，则要调用这个回调函数，其原型为：

VOID　CALLBACK　CleanupGroupCancelCallback(

PVOID pvObjectContext,PVOID pvCleanupContext)

其中pvObjectContext是通过CreateThreadpool*函数传入的pvContext，参数pvCleanupContext是由CloseThreadpoolCleanupGroupMembers的pvCleanupContext参数传入的。

备注：

①每当调用CreateThreadpool*等函数（如CreateThreadpoolTimer）时，如果其最后的回调环境参数不为NULL，那么所创建的项会被添加到回调环境的清理组中，表示线程池中新添加了一项，需要潜在的清理 。

②如果调用CloseThreadpool*（如CloseThreadpoolTimer），那么等于隐式将对应的项从清理组中删除。

参数

描述

PTP_CLEANUP_GROUP ptpcg

指向由CreateThreadpoolCleanupGroup创建的清理 组。

BOOL bCancelPendingCallbacks

是否取消线程池是剩余的工作项。

①如果bCancelPendingCallbacks指定为TRUE，则所有已提交但尚未处理工作项将被直接取消。如果之前在SetThreadpoolCallbackCleanupGroup的pfng指定了回调函数，那么对每一个被取消的项，回调函数pfng都要被调用一次。

②如果bCancelPendingCallbacks为FALSE，则在函数返回之前，线程池会花时间来处理队列中剩余的工作项。（这时CleanupGroupCancelCallback函数是不会被调用的，因此pvCleanupContext可设为NULL）

PVOID pvCleanupContext

传给CleanupGroupCancelCallback回调函数的额外参数。如果bCancelPendingCallbacks为FALSE，则CleanupGroupCancelCallback不会被调用，所以该参数可以设为NULL）。

备注：主控线程调用该函数时，该函数会一直等待，直到线程池中所有剩余的工作项都处理完毕才返回。（这点与WaitForThreadpool*函数（如WaitForThreadpoolWork）相似。