SetThreadSelectedCpuSetMasks-Funktion (processthreadsapi.h)

Legt die ausgewählte CPU-Sätze-Zuweisung für den angegebenen Thread fest. Diese Zuweisung überschreibt die Standardzuweisung des Prozesses, sofern eine festgelegt ist.

Syntax

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

Parameter

Thread

Gibt den Thread an, für den die CPU-Satzzuweisung festgelegt werden soll. PROCESS_SET_LIMITED_INFORMATION Zugriffsrecht. Der von GetCurrentProcess zurückgegebene Wert kann hier auch angegeben werden.

CpuSetMasks

Gibt einen optionalen Puffer von GROUP_AFFINITY Strukturen an, die die CPU-Sätze darstellen, die als ausgewählte CPU-Gruppe des Threads festgelegt werden sollen. Wenn dies NULL ist, löscht die SetThreadSelectedSelectedCpuSetMasks-Funktion jede Zuweisung und setzt die Standardzuweisung zurück, wenn eine festgelegt ist.

CpuSetMaskCount

Gibt die Anzahl der GROUP_AFFINITY Strukturen in der Liste an, die im GroupCpuSets-Argument übergeben werden. Wenn der Puffer NULL ist, muss dieser Wert 0 sein.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlschlägt, ist der Rückgabewert null, und erweiterte Fehlerinformationen können durch Aufrufen von GetLastError abgerufen werden.

Hinweise

Diese Funktion ist analog zu SetThreadSelectedCpuSets, außer dass sie Gruppenaffinitäten im Gegensatz zu CPU-Set-IDs verwendet, um eine Liste von CPU-Sätzen darzustellen. Dies bedeutet, dass die resultierende threadseitig ausgewählte CPU-Satzzuweisung die Gruppe aller CPU-Sätze mit einem Homeprozessor in der bereitgestellten 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