Função GetThreadPriority (processthreadsapi.h)

Artigo
08/25/2023

Recupera o valor de prioridade para o thread especificado. Esse valor, juntamente com a classe de prioridade do processo do thread, determina o nível de prioridade base do thread.

Sintaxe

int GetThreadPriority(
  [in] HANDLE hThread
);

Parâmetros

[in] hThread

Um identificador para o thread.

O identificador deve ter o direito de acesso THREAD_QUERY_INFORMATION ou THREAD_QUERY_LIMITED_INFORMATION . Para obter mais informações, consulte Segurança de thread e direitos de acesso.

Windows Server 2003: O identificador deve ter o direito de acesso THREAD_QUERY_INFORMATION .

Retornar valor

Se a função for bem-sucedida, o valor retornado será o nível de prioridade do thread.

Se a função falhar, o valor retornado será THREAD_PRIORITY_ERROR_RETURN. Para obter informações de erro estendidas, chame GetLastError.

Windows Phone 8.1: essa função sempre retornará THREAD_PRIORITY_NORMAL.

O nível de prioridade do thread é um dos valores a seguir.

Valor/código retornado	Descrição
THREAD_PRIORITY_ABOVE_NORMAL 1	Prioridade 1 ponto acima da classe de prioridade.
THREAD_PRIORITY_BELOW_NORMAL -1	Prioridade 1 ponto abaixo da classe de prioridade.
THREAD_PRIORITY_HIGHEST 2	Prioridade 2 pontos acima da classe de prioridade.
THREAD_PRIORITY_IDLE -15	Prioridade base de 1 para processos de IDLE_PRIORITY_CLASS, BELOW_NORMAL_PRIORITY_CLASS, NORMAL_PRIORITY_CLASS, ABOVE_NORMAL_PRIORITY_CLASS ou HIGH_PRIORITY_CLASS e uma prioridade base de 16 para processos de REALTIME_PRIORITY_CLASS .
THREAD_PRIORITY_LOWEST -2	Prioridade 2 pontos abaixo da classe de prioridade.
THREAD_PRIORITY_NORMAL 0	Prioridade normal para a classe de prioridade.
THREAD_PRIORITY_TIME_CRITICAL 15	Nível de prioridade base de 15 para processos de IDLE_PRIORITY_CLASS, BELOW_NORMAL_PRIORITY_CLASS, NORMAL_PRIORITY_CLASS, ABOVE_NORMAL_PRIORITY_CLASS ou HIGH_PRIORITY_CLASS e um nível de prioridade base de 31 para processos de REALTIME_PRIORITY_CLASS .

Se o thread tiver a classe base REALTIME_PRIORITY_CLASS , essa função também poderá retornar um dos seguintes valores: -7, -6, -5, -4, -3, 3, 4, 5 ou 6. Para obter mais informações, consulte Agendando prioridades.

Comentários

Cada thread tem um nível de prioridade base determinado pelo valor de prioridade do thread e pela classe de prioridade de seu processo. O sistema operacional usa o nível de prioridade base de todos os threads executáveis para determinar qual thread obtém a próxima fatia de tempo de CPU. Os threads são agendados de maneira round robin em cada nível de prioridade e somente quando não houver threads executáveis em um nível mais alto o agendamento de threads em um nível inferior ocorrerá.

Para uma tabela que mostra os níveis de prioridade base para cada combinação de classe de prioridade e valor de prioridade de thread, consulte a função SetPriorityClass .

Windows 8.1 e Windows Server 2012 R2: essa função tem suporte para aplicativos da Windows Store.

Windows Phone aplicativos da Loja 8.1:Windows Phone podem chamar essa função, mas ela não tem efeito.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [aplicativos da área de trabalho \| aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	processthreadsapi.h (inclua Windows.h no Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Biblioteca	Kernel32.lib; WindowsPhoneCore.lib no Windows Phone 8.1
DLL	Kernel32.dll; KernelBase.dll no Windows Phone 8.1