Função CreateThreadpool (threadpoolapiset.h)
Aloca um novo pool de threads para executar retornos de chamada.
Sintaxe
PTP_POOL CreateThreadpool(
PVOID reserved
);
Parâmetros
reserved
Esse parâmetro é reservado e deve ser NULL.
Retornar valor
Se a função for bem-sucedida, ela retornará um ponteiro para uma estrutura TP_POOL que representa o pool de threads recém-alocado. Os aplicativos não modificam os membros dessa estrutura.
Se a função falhar, ela retornará NULL. Para recuperar informações de erro estendidas, chame GetLastError.
Comentários
Depois de criar o novo pool de threads, você deve chamar SetThreadpoolThreadMaximum para especificar o número máximo de threads que o pool pode alocar e SetThreadpoolThreadMinimum para especificar o número mínimo de threads disponíveis no pool.
Para usar o pool, você deve associar o pool a um ambiente de retorno de chamada. Para criar o ambiente de retorno de chamada, chame InitializeThreadpoolEnvironment. Em seguida, chame SetThreadpoolCallbackPool para associar o pool ao ambiente de retorno de chamada.
Para liberar o pool de threads, chame CloseThreadpool.
Para compilar um aplicativo que usa essa função, defina _WIN32_WINNT como 0x0600 ou superior.
Exemplos
Para obter um exemplo, consulte Usando as funções do pool de threads.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | threadpoolapiset.h (inclua Windows.h no Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |