GetProcessDefaultCpuSetMasks-Funktion (processthreadsapi.h)

  • Artikel

Ruft die Liste der CPU-Sätze im Prozessstandardsatz ab, der von SetProcessDefaultCpuSetMasks oder SetProcessDefaultCpuSets festgelegt wurde.

Syntax

BOOL GetProcessDefaultCpuSetMasks(
  HANDLE          Process,
  PGROUP_AFFINITY CpuSetMasks,
  USHORT          CpuSetMaskCount,
  PUSHORT         RequiredMaskCount
);

Parameter

Process

Gibt ein Prozesshandle für den abzufragenden Prozess an. 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 Prozessstandard-CPU-Sätze 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 CpuSetMasks-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 Standard-CPU-Sätze für einen bestimmten Prozess festgelegt sind, wird der Parameter RequiredMaskCount auf 0 festgelegt, und die Funktion ist erfolgreich.

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

Anforderungen

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