Funzione SetThreadPriorityBoost (processthreadsapi.h)

Disabilita o abilita la capacità del sistema di aumentare temporaneamente la priorità di un thread.

Sintassi

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

Parametri

[in] hThread

Handle per il thread la cui priorità deve essere incrementata. L'handle deve avere il THREAD_SET_INFORMATION o THREAD_SET_LIMITED_INFORMATION diritto di accesso. Per altre informazioni, vedere Thread Security and Access Rights.For more information, see Thread Security and Access Rights.

Windows Server 2003 e Windows XP: L'handle deve avere il diritto di accesso THREAD_SET_INFORMATION .

[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 SetThreadPriorityBoost viene chiamato con il parametro DisablePriorityBoost impostato su TRUE, la priorità del thread non viene attivata. Per ripristinare il comportamento normale, chiamare SetThreadPriorityBoost 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 in Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche

GetThreadPriorityBoost

OpenThread

Incrementi di priorità

Funzioni di processi e thread

Priorità di pianificazione

Thread