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

Confira também

CloseThreadpool

SetThreadpoolThreadMaximum

SetThreadpoolThreadMinimum

Pools de threads