Funzione GetThreadGroupAffinity (processtopologyapi.h)

Recupera l'affinità del gruppo di processori del thread specificato.

Sintassi

C++
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.

[out] GroupAffinity

Puntatore a una struttura GROUP_AFFINITY che riceve 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 sull'errore estese, usare GetLastError.

Osservazioni

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 del 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.

Fabbisogno

Requisito Valore
client minimo supportato Windows 7 [solo app desktop]
server minimo supportato Windows Server 2008 R2 [solo app desktop]
piattaforma di destinazione Finestre
intestazione processtopologyapi.h (include Windows.h)
libreria Kernel32.lib
dll Kernel32.dll

Vedere anche

GetProcessGroupAffinity

gruppi di processori