SetProcessDefaultCpuSetMasks-Funktion (processthreadsapi.h)

Legt die Standardzuweisung für CPU-Sätze für Threads im angegebenen Prozess fest.

Syntax

BOOL SetProcessDefaultCpuSetMasks(
  HANDLE          Process,
  PGROUP_AFFINITY CpuSetMasks,
  USHORT          CpuSetMaskCount
);

Parameter

Process

Gibt den Prozess an, für den die STANDARD-CPU-Sätze festgelegt werden sollen. Dieses Handle muss über das PROCESS_SET_LIMITED_INFORMATION-Zugriffsrecht verfügen. Der von GetCurrentProcess zurückgegebene Wert kann auch hier angegeben werden.

CpuSetMasks

Gibt einen optionalen Puffer mit GROUP_AFFINITY Strukturen an, die die CPU-Sätze darstellen, die als Prozessstandard-CPU-Satz festgelegt werden sollen. Wenn dies NULL ist, löscht die SetProcessDefaultCpuSetMasks-Funktion jede Zuweisung.

CpuSetMaskCount

Gibt die Größe des CpuSetMasks-Arrays in Elementen an. Wenn der Puffer NULL ist, muss dieser Wert 0 sein.

Rückgabewert

Diese Funktion kann nicht fehlschlagen, wenn gültige Parameter übergeben wurden.

Hinweise

Threads, die zu diesem Prozess gehören, für die CPU-Sätze nicht explizit mit SetThreadSelectedSelectedCpuSetMasks oder SetThreadSelectedSelectedCpuSets festgelegt sind, erben die von SetProcessDefaultCpuSetMasks angegebenen Sätze automatisch.

Diese Funktion ist analog zu SetProcessDefaultCpuSets, mit der Ausnahme, dass sie Gruppenaffinitäten im Gegensatz zu CPU-Set-IDs verwendet, um eine Liste von CPU-Sätzen darzustellen. Dies bedeutet, dass die resultierende Prozess-Standard-CPU-Set-Zuweisung die Gruppe aller CPU-Sätze mit einem Homeprozessor in der angegebenen Liste der Gruppenaffinitäten ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 11
Unterstützte Mindestversion (Server)	Windows Server 2022
Kopfzeile	processthreadsapi.h
DLL	kernel32.dll