Funzione SetProcessPriorityBoost (processthreadsapi.h)

Articolo
03/05/2024

Disabilita o abilita la capacità del sistema di aumentare temporaneamente la priorità dei thread del processo specificato.

Sintassi

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

Parametri

[in] hProcess

Handle per il processo. Questo handle deve avere il diritto di accesso PROCESS_SET_INFORMATION. Per altre informazioni, vedere Elaborare diritti di sicurezza e accesso.

[in] bDisablePriorityBoost

Se questo parametro è TRUE, l'aumento dinamico è disabilitato. Se il parametro è FALSE, è abilitato il boosting dinamico.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Quando un thread viene eseguito in una delle classi di priorità dinamiche, il sistema aumenta temporaneamente la priorità del thread quando viene estratto da uno stato di attesa. Se SetProcessPriorityBoost viene chiamato con il parametro DisablePriorityBoost impostato su TRUE, le priorità dei thread non vengono incrementate. Questa impostazione influisce su tutti i thread esistenti e su tutti i thread creati successivamente dal processo. Per ripristinare il comportamento normale, chiamare SetProcessPriorityBoost con DisablePriorityBoost impostato su FALSE.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [app desktop \| App UWP]
Server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	processthreadsapi.h (includere Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll