如何使用Win32 ThreadPool API？

Question

這個版本（基於此文章）的工作原理：

#include <windows.h>
#include <tchar.h>
#include <stdio.h>

VOID
CALLBACK
MyWorkCallback(
    PTP_CALLBACK_INSTANCE Instance,
    PVOID                 Parameter,
    PTP_WORK              Work
)
{
    // Instance, Parameter, and Work not used in this example.
    UNREFERENCED_PARAMETER(Instance);
    UNREFERENCED_PARAMETER(Parameter);
    UNREFERENCED_PARAMETER(Work);

    DWORD threadId = GetCurrentThreadId();

    BOOL bRet = FALSE;

    //
    // Do something when the work callback is invoked.
    //
    {
        _tprintf(_T("MyWorkCallback: ThreadId = %d Task performed.\n"), threadId);
    }

    return;
}

int main()
{
    TP_CALLBACK_ENVIRON CallBackEnviron;
    PTP_POOL pool = NULL;
    PTP_CLEANUP_GROUP cleanupgroup = NULL;
    PTP_WORK_CALLBACK workcallback = MyWorkCallback;
    PTP_TIMER timer = NULL;
    PTP_WORK work = NULL;


    InitializeThreadpoolEnvironment(&CallBackEnviron);
    pool = CreateThreadpool(NULL);
    SetThreadpoolThreadMaximum(pool, 1);
    SetThreadpoolThreadMinimum(pool, 3);
    cleanupgroup = CreateThreadpoolCleanupGroup();
    SetThreadpoolCallbackPool(&CallBackEnviron, pool);
    SetThreadpoolCallbackCleanupGroup(&CallBackEnviron, cleanupgroup, NULL);
    work = CreateThreadpoolWork(workcallback, NULL, &CallBackEnviron);
    for (int i = 0; i < 10; ++i)
    {
        SubmitThreadpoolWork(work);
    }
}

但是，此版本也可以使用（與上面的工作功能相同）：

int main()
{
    PTP_WORK = CreateThreadpoolWork(workcallback, NULLPTR, NULLPTR);
    for (int i = 0; i < 10; ++i)
    { 
        SubmitThreadpoolWork(work);
    }
}

這兩個版本之間有什么區別（最小和最大線程數除外）？
為什么要使用一個版本而不是另一個版本？

Answer 1

InitializeThreadpoolEnvironment的文檔中對此進行了介紹：

如果計划調用以下函數之一來修改環境，請創建一個回調環境：

• SetThreadpoolCallbackCleanupGroup

• SetThreadpoolCallbackLibrary

• SetThreadpoolCallbackPool

• SetThreadpoolCallbackPriority

• SetThreadpoolCallbackRunsLong

如果您需要列出的一個或多個功能提供的功能，則需要創建一個回調環境。 如果不這樣做，就不會。

如果在開始新項目時有疑問，請使用簡單的方法開始，並查看它是否滿足您的需求。 如果有必要，您總是可以返回並切換到更復雜的變體。