Funzione SetThreadSelectedCpuSetMasks (processthreadsapi.h)

  • Articolo

Imposta l'assegnazione dei set di CPU selezionati per il thread specificato. Questa assegnazione sostituisce l'assegnazione predefinita del processo, se impostata.

Sintassi

BOOL SetThreadSelectedCpuSetMasks(
  HANDLE          Thread,
  PGROUP_AFFINITY CpuSetMasks,
  USHORT          CpuSetMaskCount
);

Parametri

Thread

Specifica il thread in cui impostare l'assegnazione del set di CPU. PROCESS_SET_LIMITED_INFORMATION diritto di accesso. Il valore restituito da GetCurrentProcess può essere specificato anche qui.

CpuSetMasks

Specifica un buffer facoltativo di strutture GROUP_AFFINITY che rappresentano i set di CPU da impostare come set di CPU selezionato dal thread. Se è NULL, la funzione SetThreadSelectedCpuSetMasks cancella qualsiasi assegnazione, ripristinando l'assegnazione predefinita se impostata.

CpuSetMaskCount

Specifica il numero di strutture GROUP_AFFINITY nell'elenco passato nell'argomento GroupCpuSets. Se il buffer è NULL, questo valore deve essere zero.

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.

Commenti

Questa funzione è analoga a SetThreadSelectedCpuSets, 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 l'assegnazione del set di CPU selezionato dal thread risultante è il set di tutti i set di CPU con un processore home nell'elenco fornito di affinità di gruppo.

Requisiti

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