Função InitializeThreadpoolEnvironment (winbase.h)

Inicializa um ambiente de retorno de chamada.

Sintaxe

VOID InitializeThreadpoolEnvironment(
  [out] PTP_CALLBACK_ENVIRON pcbe
);

Parâmetros

[out] pcbe

Uma estrutura TP_CALLBACK_ENVIRON que define um ambiente de retorno de chamada.

Retornar valor

Nenhum

Comentários

Por padrão, um retorno de chamada é executado no pool de threads padrão para o processo. Nenhum grupo de limpeza está associado ao ambiente de retorno de chamada, o chamador é responsável por manter a DLL do retorno de chamada carregada enquanto há retornos de chamada pendentes e espera-se que o retorno de chamada seja executado em um período razoável para o aplicativo.

Crie um ambiente de retorno de chamada se você planeja chamar uma das seguintes funções para modificar o ambiente:

• SetThreadpoolCallbackCleanupGroup
• SetThreadpoolCallbackLibrary
• SetThreadpoolCallbackPool
• SetThreadpoolCallbackPriority
• SetThreadpoolCallbackRunsLong

• CreateThreadpoolIo
• CreateThreadpoolTimer
• CreateThreadpoolWait
• CreateThreadpoolWork
• TrySubmitThreadpoolCallback

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

DestroyThreadpoolEnvironment

SetThreadpoolCallbackCleanupGroup

SetThreadpoolCallbackLibrary

SetThreadpoolCallbackPool

SetThreadpoolCallbackRunsLong

Pools de threads