Funzione GetProcessGroupAffinity (processtopologyapi.h)

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

Sintassi

BOOL GetProcessGroupAffinity(
  [in]      HANDLE  hProcess,
  [in, out] PUSHORT GroupCount,
  [out]     PUSHORT GroupArray
);

Parametri

[in] hProcess

Handle per il processo.

Questo handle deve avere il diritto di accesso PROCESS_QUERY_INFORMATION o PROCESS_QUERY_LIMITED_INFORMATION. Per altre informazioni, vedere Sicurezza dei processi e diritti di accesso.

[in, out] GroupCount

In base all'input, specifica il numero di elementi nella matrice GroupArray . Nell'output specifica il numero di gruppi di processori scritti nella matrice. Se la matrice è troppo piccola, la funzione ha esito negativo con ERROR_INSUFFICIENT_BUFFER e imposta il parametro GroupCount sul numero di elementi necessari.

[out] GroupArray

Matrice di numeri del gruppo di processori. Un numero di gruppo viene incluso nella matrice se un thread nel processo viene assegnato a un processore nel gruppo.

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.

Se il valore di errore è ERROR_INSUFFICIENT_BUFFER, il parametro GroupCount contiene le dimensioni del buffer necessarie nel numero di elementi.

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.

Per compilare un'applicazione che usa questa funzione, impostare _WIN32_WINNT = 0x0601 >. Per altre informazioni, vedere Uso delle intestazioni di Windows.

Requisiti

Vedere anche

GetThreadGroupAffinity

Gruppi di processori