Função SetProcessPriorityBoost (processthreadsapi.h)

Desabilita ou permite que a capacidade do sistema de aumentar temporariamente a prioridade dos threads do processo especificado.

Sintaxe

BOOL SetProcessPriorityBoost(
  [in] HANDLE hProcess,
  [in] BOOL   bDisablePriorityBoost
);

Parâmetros

[in] hProcess

Um identificador para o processo. Esse identificador deve ter o acesso de PROCESS_SET_INFORMATION correto. Para obter mais informações, consulte Direitos de Acesso e Segurança do Processo.

[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 SetProcessPriorityBoost for chamado com o parâmetro DisablePriorityBoost definido como TRUE, as prioridades de seus threads não serão aumentadas. Essa configuração afeta todos os threads existentes e todos os threads posteriormente criados pelo processo. Para restaurar o comportamento normal, chame SetProcessPriorityBoost com DisablePriorityBoost definido como FALSE.

Requisitos

Confira também

GetProcessPriorityBoost

Aumentos de prioridade

Funções de thread e processo

Processos

Prioridades de agendamento