Função SetThreadPriorityBoost (processthreadsapi.h)

Artigo
03/01/2024

Desabilita ou permite que o sistema aumente temporariamente a prioridade de um thread.

Sintaxe

BOOL SetThreadPriorityBoost(
  [in] HANDLE hThread,
  [in] BOOL   bDisablePriorityBoost
);

Parâmetros

[in] hThread

Um identificador para o thread cuja prioridade deve ser aumentada. O identificador deve ter o acesso THREAD_SET_INFORMATION ou THREAD_SET_LIMITED_INFORMATION correto. Para obter mais informações, consulte Segurança de thread e direitos de acesso.

Windows Server 2003 e Windows XP: O identificador deve ter o acesso THREAD_SET_INFORMATION correto.

[in] bDisablePriorityBoost

Se esse parâmetro for TRUE, o aumento dinâmico será desabilitado. Se o parâmetro for FALSE, o aumento dinâmico será habilitado.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

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

Comentários

Quando um thread está em execução em uma das classes de prioridade dinâmica, o sistema aumenta temporariamente a prioridade do thread quando ele é retirado de um estado de espera. Se SetThreadPriorityBoost for chamado com o parâmetro DisablePriorityBoost definido como TRUE, a prioridade do thread não será aumentada. Para restaurar o comportamento normal, chame SetThreadPriorityBoost com DisablePriorityBoost definido como FALSE.

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
DLL	Kernel32.dll