Función SetProcessPriorityBoost (processthreadsapi.h)

Deshabilita o permite que el sistema aumente temporalmente la prioridad de los subprocesos del proceso especificado.

Sintaxis

BOOL SetProcessPriorityBoost(
  [in] HANDLE hProcess,
  [in] BOOL   bDisablePriorityBoost
);

Parámetros

[in] hProcess

Identificador del proceso. Este identificador debe tener el derecho de acceso PROCESS_SET_INFORMATION. Para obtener más información, consulte Derechos de acceso y seguridad de procesos.

[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 SetProcessPriorityBoost con el parámetro DisablePriorityBoost establecido en TRUE, no se potencian las prioridades de sus subprocesos. Esta configuración afecta a todos los subprocesos existentes y a los subprocesos creados posteriormente por el proceso. Para restaurar el comportamiento normal, llame a SetProcessPriorityBoost 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)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll

Vea también

GetProcessPriorityBoost

Aumentos de prioridad

Funciones de proceso y subproceso

Procesos

Prioridades de programación