IHostTask::SetPriority (Método)

Artículo
08/23/2008

Actualización: noviembre 2007

Solicita que el host ajuste el nivel de prioridad de subprocesamiento para la tarea representada por la instancia de IHostTask actual.

HRESULT SetPriority (
    [in] int newPriority
);

Parámetros

newPriority
[in] Entero que representa el valor de prioridad de subproceso solicitado para la tarea representada por la instancia de IHostTask actual.

Valor devuelto

HRESULT	Descripción
S_OK	SetPriority se devolvió correctamente.
HOST_E_CLRNOTAVAILABLE	Common Language Runtime (CLR) no se ha cargado en un proceso o está en un estado en el que no puede ejecutar el código administrado o procesar la llamada correctamente.
HOST_E_TIMEOUT	Se agotó el tiempo de espera de la llamada.
HOST_E_NOT_OWNER	El llamador no posee el bloqueo.
HOST_E_ABANDONED	Se canceló un evento mientras una fibra o un subproceso bloqueado estaba esperándole.
E_FAIL	Se ha producido un error catastrófico desconocido. Si un método devuelve E_FAIL, CLR no se puede seguir utilizando en el proceso. Las llamadas subsiguientes a métodos de hospedaje devuelven HOST_E_CLRNOTAVAILABLE.

Comentarios

A los subprocesos se les concede el tiempo de procesamiento utilizando un sistema de operación por turnos que se basa parcialmente en el nivel de prioridad de subprocesamiento. SetPriority permite a CLR establecer dicho nivel de prioridad de subprocesamiento para la tarea actual. Se admiten los valores de newPriority siguientes.

THREAD_PRIORITY_ABOVE_NORMAL
THREAD_PRIORITY_BELOW_NORMAL
THREAD_PRIORITY_HIGHEST
THREAD_PRIORITY_IDLE
THREAD_PRIORITY_LOWEST
THREAD_PRIORITY_NORMAL
THREAD_PRIORITY_TIME_CRITICAL

CLR llama a SetPriority cuando el código de usuario modifica el valor de Thread.Priority. El host puede definir sus propios algoritmos para la asignación de las prioridades de subproceso, y es libre de omitir esta solicitud.

Nota

Si el nivel de prioridad de subproceso cambia, SetPriority no informará de ello. Llame a IHostTask::GetPriority para determinar el valor del nivel de prioridad de subprocesamiento de la tarea.

La función de Win32 SetThreadPriority define los valores de los niveles de prioridad de subprocesamiento. Para obtener más información sobre la prioridad de los subprocesos, consulte la documentación de la plataforma Windows.