Método de IHostTask::SetPriority
Nível de solicitações que o host de ajustar a prioridade do thread para tarefa representada pela atual 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 atual IHostTask instância.
Valor de retorno
HRESULT |
Descrição |
|---|---|
S_OK |
SetPriorityretornado com êxito. |
HOST_E_CLRNOTAVAILABLE |
O common language runtime (CLR) não foi carregado em um processo ou o CLR é em um estado em que ele não é possível executar código gerenciado ou processar a chamada com êxito. |
HOST_E_TIMEOUT |
A chamada foi esgotado. |
HOST_E_NOT_OWNER |
O chamador não possui o bloqueio. |
HOST_E_ABANDONED |
Um evento foi cancelado, enquanto um segmento bloqueado ou fibra estava esperando por ele. |
E_FAIL |
Ocorreu uma falha catastrófica desconhecida. Quando um método retorna E_FAIL, o CLR não é usável dentro do processo. As chamadas subseqüentes para hospedar os métodos retornam HOST_E_CLRNOTAVAILABLE. |
Comentários
Segmentos são concedidas tempo de processamento usando um sistema de rodízio é parcialmente baseado no nível de prioridade do segmento. SetPrioritypermite que o CLR definir esse nível de prioridade de thread para a tarefa atual. O seguinte newPriority os valores são suportados.
THREAD_PRIORITY_ABOVE_NORMAL
THREAD_PRIORITY_BELOW_NORMAL
THREAD_PRIORITY_HIGHEST
THREAD_PRIORITY_IDLE
COMO THREAD_PRIORITY_LOWEST
THREAD_PRIORITY_NORMAL
THREAD_PRIORITY_TIME_CRITICAL
As chamadas CLR SetPriority quando o valor de 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á livre para ignorar essa solicitação.
Observação
SetPrioritynão relata se o nível de prioridade de thread foi alterado.Chame IHostTask::GetPriority para determinar o valor do 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 a prioridade de thread, consulte a documentação da plataforma Windows.
Requisitos
Plataformas: Consulte Requisitos de sistema do .NET Framework.
Cabeçalho: MSCorEE.h
Biblioteca: Incluído como um recurso em mscoree
.NET Framework versões: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0