Funzione GetThreadGroupAffinity (processtopologyapi.h)
Recupera l'affinità del gruppo di processori del thread specificato.
Sintassi
BOOL GetThreadGroupAffinity(
[in] HANDLE hThread,
[out] PGROUP_AFFINITY GroupAffinity
);
Parametri
[in] hThread
Handle per il thread per cui si desidera l'affinità del gruppo di processori.
L'handle deve avere il diritto di accesso THREAD_QUERY_INFORMATION o THREAD_QUERY_LIMITED_INFORMATION. Per altre informazioni, vedere Thread Security and Access Rights.For more information, see Thread Security and Access Rights.
[out] GroupAffinity
Puntatore a una struttura GROUP_AFFINITY per ricevere l'affinità di gruppo del thread.
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 estese sull'errore, usare GetLastError.
Commenti
A partire da Windows 11 e Windows Server 2022, in un sistema con più di 64 processori, affinità tra processi e thread si estendono su tutti i processori nel sistema, in tutti i gruppi di processori, per impostazione predefinita. La funzione GetThreadGroupAffinity recupera l'affinità di gruppo sul 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 (include Windows.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |