Método ICLRTask::NeedsPriorityScheduling
Obtém um valor que indica se a tarefa atual, que está a ser desativada, tem de ser marcada como uma prioridade elevada para reagendamento.
Sintaxe
HRESULT NeedsPriorityScheduling (
[out] BOOL *pbNeedsPriorityScheduling
);
Parâmetros
pbNeedsPriorityRescheduling
[out] true
, se o anfitrião deve tentar reagendar a instância de tarefa atual o mais rapidamente possível; caso contrário, false
.
Devolver Valor
HRESULT | Description |
---|---|
S_OK | NeedsPriorityRescheduling devolvido com êxito. |
HOST_E_CLRNOTAVAILABLE | O runtime de linguagem comum (CLR) não foi carregado para um processo ou o CLR está num estado em que não pode executar código gerido ou processar a chamada com êxito. |
HOST_E_TIMEOUT | A chamada excedeu o limite de tempo. |
HOST_E_NOT_OWNER | O autor da chamada não é o proprietário do bloqueio. |
HOST_E_ABANDONED | Um evento foi cancelado enquanto um thread ou fibra bloqueado estava à espera. |
E_FAIL | Ocorreu uma falha catastrófica desconhecida. Quando um método devolve E_FAIL, o CLR já não é utilizável no processo. As chamadas subsequentes para métodos de alojamento devolvem HOST_E_CLRNOTAVAILABLE. |
Observações
Em situações em que a tarefa está perto de ser recolhida pelo recoletor de lixo, o CLR define o valor de pbNeedsPriorityScheduling
como true
, indicando reagendamento de alta prioridade. Isto permite ao anfitrião reagendar a tarefa rapidamente, minimizando assim o potencial de atrasos na libertação da memória e permitindo que o anfitrião e o runtime cooperem na conservação de recursos de memória.
Requisitos
Plataformas: Veja Requisitos de Sistema.
Cabeçalho: MSCorEE.h
Biblioteca: Incluído como um recurso no MSCorEE.dll
.NET Framework Versões: Disponível desde 2.0