Método IHostTask::SetPriority

Artigo
08/25/2010

Solicitações que o host ajustar o nível de prioridade do thread para tarefa representada pelo corrente IHostTask instância.

HRESULT SetPriority (
    [in] int newPriority
);

Parâmetros

newPriority
[in] Um inteiro que representa o valor de prioridade de thread solicitada para a tarefa representado pelo corrente IHostTask instância.

Valor de retorno

HRESULT	Descrição
S_OK	SetPriority retornado com êxito.
HOST_E_CLRNOTAVAILABLE	O common linguagem tempo de execução (CLR) não foi carregado em um processo ou o CLR está em um estado em que ele não possa executar código gerenciado ou processar a telefonar com êxito.
HOST_E_TIMEOUT	A telefonar expirou.
HOST_E_NOT_OWNER	O chamador não é proprietário do bloquear.
HOST_E_ABANDONED	Um evento foi cancelado enquanto um segmento bloqueado ou fibra estava aguardando nele.
E_FAIL	Ocorreu uma falha catastrófica desconhecida. Quando um método retorna E_FAIL, o CLR não é mais útil dentro do processo. As chamadas subseqüentes à hospedagem métodos retornam HOST_E_CLRNOTAVAILABLE.

Comentários

Segmentos são concedidas time de processamento usando um sistema de round-robin baseia-se parcialmente no nível de prioridade do segmento. SetPriority permite que o CLR conjunto esse nível de prioridade thread para a tarefa corrente. A seguir newPriority os valores são suportados.

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 da Thread.Priority é modificada pelo código do usuário. Um host pode definir seus próprios algoritmos para atribuição de prioridade de thread e está disponível para ignorar essa solicitação.

Observação:
SetPriority não relata se o nível de prioridade do thread foi alterado. De telefonarIHostTask::GetPriority para determinar o valor de nível de prioridade de thread da tarefa.

Valores de nível de prioridade do thread são definidos pelo Win32 SetThreadPriority função. Para obter mais informações sobre prioridade de thread, consulte a documentação da plataforma Windows.