Função CallbackMayRunLong (threadpoolapiset.h)

Indica que o retorno de chamada pode não retornar rapidamente.

Sintaxe

BOOL CallbackMayRunLong(
  [in, out] PTP_CALLBACK_INSTANCE pci
);

Parâmetros

[in, out] pci

Um ponteiro para uma estrutura TP_CALLBACK_INSTANCE que define a instância de retorno de chamada. O ponteiro é passado para a função de retorno de chamada.

Retornar valor

A função retornará TRUE se outro thread no pool de threads estiver disponível para processar retornos de chamada ou se o pool de threads puder criar um novo thread. Nesse caso, a função de retorno de chamada atual pode usar o thread atual indefinidamente.

A função retornará FALSE se outro thread no pool de threads não estiver disponível para processar retornos de chamada e o pool de threads não puder criar um novo thread. O pool de threads tentará criar um novo thread após um atraso, mas se a função de retorno de chamada atual for executada por muito tempo, o pool de threads poderá perder eficiência.

Comentários

O pool de threads pode usar essas informações para determinar melhor quando um novo thread deve ser criado.

A função CallbackMayRunLong deve ser chamada apenas pelo thread que está processando o retorno de chamada. Chamar essa função de outro thread pode causar uma condição de corrida.

A função CallbackMayRunLong sempre marca o retorno de chamada como de execução longa, se um thread está disponível ou não para processar retornos de chamada ou se o threadpool é capaz de alocar um novo thread. Portanto, essa função deve ser chamada apenas uma vez, mesmo que retorne FALSE.

Para compilar um aplicativo que usa essa função, defina _WIN32_WINNT como 0x0600 ou superior.

Requisitos

Confira também

DisassociateCurrentThreadFromCallback

FreeLibraryWhenCallbackReturns

LeaveCriticalSectionWhenCallbackReturns

ReleaseMutexWhenCallbackReturns

ReleaseSemaphoreWhenCallbackReturns

SetEventWhenCallbackReturns

SetThreadpoolCallbackRunsLong

Pools de threads

TrySubmitThreadpoolCallback