Compartir a través de

IHostTask::SetPriority (Método)

  • Artículo

Solicita que el host ajuste el nivel de prioridad del subproceso para la tarea que representa la instancia de IHostTask actual.

Sintaxis

HRESULT SetPriority (  
    [in] int newPriority  
);

Parámetros

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

Valor devuelto

HRESULT Descripción
S_OK SetPriority se devolvió correctamente.
HOST_E_CLRNOTAVAILABLE El Common Language Runtime (CLR) no se ha cargado en un proceso o se encuentra en un estado en el que no puede ejecutar 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 autor de la llamada no es el propietario del bloqueo.
HOST_E_ABANDONED Se canceló un evento mientras que una fibra o subproceso que estaba bloqueado lo estaba esperando.
E_FAIL Ocurrió un error grave desconocido. Si un método devuelve el valor E_FAIL, el CLR ya no se podrá usar en el proceso. Las llamadas que se hagan a los métodos de hospedaje posteriormente devolverán el valor HOST_E_CLRNOTAVAILABLE.

Comentarios

A los subprocesos se les concede tiempo de procesamiento mediante un sistema round robin que se basa parcialmente en el nivel de prioridad de un subproceso. SetPriority permite que CLR establezca ese nivel de prioridad del subproceso para la tarea actual. Se admiten los valores 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 valor de Thread.Priority lo modifica el código de usuario. Un host puede definir sus propios algoritmos para la asignación de prioridad del subproceso y es libre de omitir esta solicitud.

Nota

SetPriority no notifica si se ha cambiado el nivel de prioridad del subproceso. Llame a IHostTask::GetPriority para determinar el valor del nivel de prioridad del subproceso de la tarea.

Los valores del nivel de prioridad del subproceso los define la función SetThreadPriority de Win32. Para obtener más información acerca de la prioridad del subproceso, vea la documentación de la Plataforma Windows.

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: MSCorEE.h

Biblioteca: incluida como recurso en MSCorEE.dll

Versiones de .NET Framework: disponible a partir de la versión 2.0

Consulte también