Compartir a través de


Función SetThreadPriorityBoost (processthreadsapi.h)

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

Vea también

GetThreadPriorityBoost

OpenThread

Aumentos de prioridad

Funciones de proceso y subproceso

Prioridades de programación

Subprocesos