Compartilhar via


Função SetThreadpoolCallbackPriority (winbase.h)

Especifica a prioridade de uma função de retorno de chamada em relação a outros itens de trabalho no mesmo pool de threads.

Sintaxe

void SetThreadpoolCallbackPriority(
  [in, out] PTP_CALLBACK_ENVIRON pcbe,
  [in]      TP_CALLBACK_PRIORITY Priority
);

Parâmetros

[in, out] pcbe

Uma estrutura TP_CALLBACK_ENVIRON que define o ambiente de retorno de chamada. A função InitializeThreadpoolEnvironment retorna essa estrutura.

[in] Priority

A prioridade para o retorno de chamada em relação a outros retornos de chamada no mesmo pool de threads. Esse parâmetro pode ser um dos seguintes valores de enumeração TP_CALLBACK_PRIORITY :

Valor Significado
TP_CALLBACK_PRIORITY_HIGH
O retorno de chamada deve ser executado em alta prioridade.
TP_CALLBACK_PRIORITY_LOW
O retorno de chamada deve ser executado com baixa prioridade.
TP_CALLBACK_PRIORITY_NORMAL
O retorno de chamada deve ser executado com prioridade normal.

Valor retornado

Nenhum

Comentários

Há garantia de que os retornos de chamada de prioridade mais alta sejam executados primeiro pelo primeiro thread de trabalho disponível, mas não há garantia de que eles sejam concluídos antes dos retornos de chamada de prioridade mais baixa.

Essa função é implementada como uma função embutida.

Para compilar um aplicativo que usa essa função, defina _WIN32_WINNT >= _WIN32_WINNT_WIN7. Para obter mais informações, consulte Usando os cabeçalhos do Windows.

Requisitos

   
Cliente mínimo com suporte Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho winbase.h (inclua Windows.h)