Função TpSetCallbackPriority (winnt.h)

Artigo
08/27/2023

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 TpSetCallbackPriority(
  [in, out] PTP_CALLBACK_ENVIRON CallbackEnviron,
  [in]      TP_CALLBACK_PRIORITY Priority
);

Parâmetros

[in, out] CallbackEnviron

Uma estrutura TP_CALLBACK_ENVIRON que define o ambiente de retorno de chamada. A função TpInitializeCallbackEnviron 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 com 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.