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

Vedere anche

GROUP_AFFINITY