Funzione GetThreadGroupAffinity (processtopologyapi.h)

  • Articolo

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

Vedere anche

GetProcessGroupAffinity

Gruppi di processori