Partilhar via

IHostTask::SetPriorityMethod

Solicita ao host que ajuste o nível de prioridade do thread para a tarefa representada pela instância atual do IHostTask .

Sintaxe

HRESULT SetPriority (
    [in] int newPriority
);

Parâmetros

newPriority [dentro] Um inteiro que representa o valor de prioridade do thread solicitado para a tarefa representada pela instância atual IHostTask .

Valor de retorno

HRESULT Descrição
S_OK SetPriority regressou com sucesso.
HOST_E_CLRNOTAVAILABLE O tempo de execução da linguagem comum (CLR) não foi carregado num processo, ou o CLR está num estado em que não consegue executar código gerido nem processar a chamada com sucesso.
HOST_E_TIMEOUT A chamada expirou.
HOST_E_NOT_OWNER O chamador não é dono da fechadura.
HOST_E_ABANDONED Um evento foi cancelado enquanto um fio ou fibra bloqueada estava à espera.
E_FAIL Ocorreu uma falha catastrófica desconhecida. Quando um método retorna E_FAIL, o CLR deixa de ser utilizado dentro do processo. As chamadas subsequentes para sistemas de alojamento regressam HOST_E_CLRNOTAVAILABLE.

Observações

As threads recebem tempo de processamento através de um sistema round-robin que se baseia parcialmente no nível de prioridade da thread. SetPriority permite ao CLR definir esse nível de prioridade de thread para a tarefa atual. São suportados os seguintes newPriority valores.

  • THREAD_PRIORITY_ABOVE_NORMAL

  • THREAD_PRIORITY_BELOW_NORMAL

  • THREAD_PRIORITY_HIGHEST

  • THREAD_PRIORITY_IDLE

  • THREAD_PRIORITY_LOWEST

  • THREAD_PRIORITY_NORMAL

  • THREAD_PRIORITY_TIME_CRITICAL

O CLR chama SetPriority quando o valor de é Thread.Priority modificado pelo código do utilizador. Um host pode definir os seus próprios algoritmos para atribuição de prioridade de threads, e é livre de ignorar este pedido.

Observação

SetPriority não informa se o nível de prioridade da thread foi alterado. Ligue para o IHostTask::GetPriority para determinar o valor do nível de prioridade do thread da tarefa.

Os valores de prioridade da thread são definidos pela função Win32 SetThreadPriority . Para mais informações sobre prioridade de threads, consulte a documentação da Windows Platform.

Requisitos

Plataformas: Consulte Requisitos do sistema.

Cabeçalho: MSCorEE.h

Biblioteca: Incluído como recurso em MSCorEE.dll

Versões do .NET Framework: Disponível desde: 2.0

Consulte também

  • Last updated on