Funzione GetProcessDefaultCpuSetMasks (processthreadsapi.h)

Articolo
08/25/2023

Recupera l'elenco dei set di CPU nel set predefinito del processo impostato da SetProcessDefaultCpuSetMasks o SetProcessDefaultCpuSets.

Sintassi

BOOL GetProcessDefaultCpuSetMasks(
  HANDLE          Process,
  PGROUP_AFFINITY CpuSetMasks,
  USHORT          CpuSetMaskCount,
  PUSHORT         RequiredMaskCount
);

Parametri

Process

Specifica un handle di processo per la query del processo. Questo handle deve avere il diritto di accesso PROCESS_QUERY_LIMITED_INFORMATION . Il valore restituito da GetCurrentProcess può essere specificato anche qui.

CpuSetMasks

Specifica un buffer facoltativo per recuperare un elenco di strutture GROUP_AFFINITY che rappresentano i set di CPU predefiniti del processo.

CpuSetMaskCount

Specifica le dimensioni della matrice CpuSetMasks , negli elementi.

RequiredMaskCount

In caso di esito positivo, specifica il numero di strutture di affinità scritte nella matrice. Se la matrice CpuSetMasks è troppo piccola, la funzione ha esito negativo con ERROR_INSUFFICIENT_BUFFER e imposta il parametro RequiredMaskCount sul numero di elementi necessari. Il numero di elementi necessari è sempre minore o uguale al numero massimo di gruppi restituito da GetMaximumProcessorGroupCount.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero e le informazioni di errore estese possono essere recuperate chiamando GetLastError.

Se la matrice fornita è troppo piccola, il valore di errore è ERROR_INSUFFICIENT_BUFFER e RequiredMaskCount è impostato sul numero di elementi necessari.

Commenti

Se non vengono impostati set di set di CPU predefiniti per un determinato processo, il parametro RequiredMaskCount è impostato su 0 e la funzione ha esito positivo.

Questa funzione è analoga a GetProcessDefaultCpuSets, ad eccezione del fatto che usa affinità di gruppo anziché ID set di CPU per rappresentare un elenco di set di CPU. Ciò significa che i set di CPU predefiniti del processo vengono mappati ai processori home e questi processori vengono recuperati nell'elenco risultante di affinità di gruppo.

Requisiti


Client minimo supportato	Windows 11
Server minimo supportato	Windows Server 2022
Intestazione	processthreadsapi.h
DLL	kernel32.dll

Condividi tramite