Función SetThreadPriorityBoost (processthreadsapi.h)

Artículo
03/05/2024

Deshabilita o permite que el sistema aumente temporalmente la prioridad de un subproceso.

Sintaxis

BOOL SetThreadPriorityBoost(
  [in] HANDLE hThread,
  [in] BOOL   bDisablePriorityBoost
);

Parámetros

[in] hThread

Identificador del subproceso cuya prioridad se va a aumentar. El identificador debe tener el derecho de acceso THREAD_SET_INFORMATION o THREAD_SET_LIMITED_INFORMATION . Para obtener más información, consulte Derechos de acceso y seguridad de subprocesos.

Windows Server 2003 y Windows XP: El identificador debe tener el derecho de acceso THREAD_SET_INFORMATION .

[in] bDisablePriorityBoost

Si este parámetro es TRUE, la potenciación dinámica está deshabilitada. Si el parámetro es FALSE, se habilita la potenciación dinámica.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Cuando un subproceso se ejecuta en una de las clases de prioridad dinámica, el sistema aumenta temporalmente la prioridad del subproceso cuando se quita de un estado de espera. Si se llama a SetThreadPriorityBoost con el parámetro DisablePriorityBoost establecido en TRUE, no se aumenta la prioridad del subproceso. Para restaurar el comportamiento normal, llame a SetThreadPriorityBoost con DisablePriorityBoost establecido en FALSE.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [aplicaciones de escritorio \| aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	processthreadsapi.h (incluya Windows.h en Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll