Funzione GetThreadSelectedCpuSetMasks (processthreadsapi.h)

Articolo
03/01/2024

Restituisce l'assegnazione esplicita del set di CPU del thread specificato, se è stata impostata un'assegnazione usando SetThreadSelectedCpuSetMasks o SetThreadSelectedCpuSets.

Sintassi

BOOL GetThreadSelectedCpuSetMasks(
  HANDLE          Thread,
  PGROUP_AFFINITY CpuSetMasks,
  USHORT          CpuSetMaskCount,
  PUSHORT         RequiredMaskCount
);

Parametri

Thread

Specifica il thread per cui eseguire una query sui set di CPU selezionati. 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 selezionati dal thread.

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 è 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 sugli errori estese possono essere recuperate chiamando GetLastError.

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

Commenti

Se non è impostata alcuna assegnazione esplicita, RequiredMaskCount è impostato su 0 e la funzione ha esito positivo.

Questa funzione è analoga a GetThreadSelectedCpuSets, ad eccezione del fatto che usa le affinità di gruppo anziché gli ID set di CPU per rappresentare un elenco di set di CPU. Ciò significa che il thread selezionato set di CPU viene mappato ai processori home e tali processori vengono recuperati nell'elenco risultante di affinità di gruppo.

Requisiti

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

Condividi tramite