GetThreadSelectedCpuSetMasks-Funktion (processthreadsapi.h)

Artikel
03/01/2024

Gibt die explizite CPU-Satzzuweisung des angegebenen Threads zurück, wenn eine Zuweisung mithilfe von SetThreadSelectedCpuSetMasks oder SetThreadSelectedCpuSets festgelegt wurde.

Syntax

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

Parameter

Thread

Gibt den Thread an, für den die ausgewählten CPU-Sätze abfragt werden sollen. Dieses Handle muss über das zugriffsrecht PROCESS_QUERY_LIMITED_INFORMATION verfügen. Der von GetCurrentProcess zurückgegebene Wert kann auch hier angegeben werden.

CpuSetMasks

Gibt einen optionalen Puffer an, um eine Liste von GROUP_AFFINITY Strukturen abzurufen, die die ausgewählten CPU-Sätze des Threads darstellen.

CpuSetMaskCount

Gibt die Größe des CpuSetMasks-Arrays in Elementen an.

RequiredMaskCount

Gibt bei erfolgreicher Rückgabe die Anzahl der Affinitätsstrukturen an, die in das Array geschrieben werden. Wenn das Array zu klein ist, schlägt die Funktion mit ERROR_INSUFFICIENT_BUFFER fehl und legt den RequiredMaskCount-Parameter auf die Anzahl der erforderlichen Elemente fest. Die Anzahl der erforderlichen Elemente ist immer kleiner oder gleich der maximalen Gruppenanzahl, die von GetMaximumProcessorGroupCount zurückgegeben wird.

Rückgabewert

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

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

Wenn das angegebene Array zu klein ist, wird der Fehlerwert ERROR_INSUFFICIENT_BUFFER und der RequiredMaskCount auf die Anzahl der erforderlichen Elemente festgelegt.

Hinweise

Wenn keine explizite Zuweisung festgelegt ist, wird RequiredMaskCount auf 0 festgelegt, und die Funktion ist erfolgreich.

Diese Funktion ist analog zu GetThreadSelectedCpuSets, 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 ausgewählten CPU-Sätze des Threads ihren Heimprozessoren zugeordnet sind und diese Prozessoren in der resultierenden Liste der Gruppenaffinitäten abgerufen werden.

Anforderungen

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

Freigeben über