Funzione SetThreadGroupAffinity (processtopologyapi.h)
Imposta l'affinità del gruppo di processori per il thread specificato.
Sintassi
BOOL SetThreadGroupAffinity(
[in] HANDLE hThread,
[in] const GROUP_AFFINITY *GroupAffinity,
[out, optional] PGROUP_AFFINITY PreviousGroupAffinity
);
Parametri
[in] hThread
Handle per il thread.
L'handle deve avere il diritto di accesso THREAD_SET_INFORMATION. Per altre informazioni, vedere Thread Security and Access Rights.For more information, see Thread Security and Access Rights.
[in] GroupAffinity
Struttura GROUP_AFFINITY che specifica l'affinità del gruppo di processore da usare per il thread specificato.
[out, optional] PreviousGroupAffinity
Puntatore a una struttura GROUP_AFFINITY per ricevere l'affinità del gruppo precedente del thread. Questo parametro può essere NULL.
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 ottenere informazioni sull'errore estese, usare GetLastError.
Commenti
A partire da Windows 11 e Windows Server 2022, in un sistema con più di 64 processori, processi e affinità di thread si estendono su tutti i processori nel sistema, in tutti i gruppi di processori, per impostazione predefinita. La funzione SetThreadGroupAffinity limita l'affinità di un thread ai processori nel gruppo di processori singolo specificato da GroupAffinity specificato. Questo gruppo diventerà anche il gruppo primario del thread.
Per compilare un'applicazione che usa questa funzione, impostare _WIN32_WINNT = 0x0601 >. Per altre informazioni, vedere Uso delle intestazioni di Windows.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows 7 [solo app desktop] |
Server minimo supportato | Windows Server 2008 R2 [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | processtopologyapi.h |
Libreria | Kernel32.lib |
DLL | Kernel32.dll |