Funzione GetThreadSelectedCpuSetMasks (processthreadsapi.h)

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

Sintassi

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

Parametri

Thread

Specifica il thread per il quale eseguire una query sui set di CPU selezionati. Questo handle deve avere il diritto di accesso PROCESS_QUERY_LIMITED_INFORMATION . Anche il valore restituito da GetCurrentProcess può essere specificato 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 estese sull'errore 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.

Osservazioni:

Se non viene 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 affinità di gruppo anziché 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