Função SetThreadPriorityBoost (processthreadsapi.h)
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 |