GetSystemCpuSetInformation-Funktion (processthreadsapi.h)

Ermöglicht einer Anwendung, die verfügbaren CPU-Sätze auf dem System und ihren aktuellen Zustand abzufragen.

Syntax

BOOL GetSystemCpuSetInformation(
  PSYSTEM_CPU_SET_INFORMATION Information,
  ULONG                       BufferLength,
  PULONG                      ReturnedLength,
  HANDLE                      Process,
  ULONG                       Flags
);

Parameter

Information

Ein Zeiger auf eine SYSTEM_CPU_SET_INFORMATION Struktur, die die CPU-Satzdaten empfängt. Übergeben Sie NULL mit einer Pufferlänge von 0, um die erforderliche Puffergröße zu bestimmen.

BufferLength

Die Länge des Als Information-Arguments übergebenen Ausgabepuffers in Bytes.

ReturnedLength

Die Länge der gültigen Daten im Ausgabepuffer in Bytes, wenn der Puffer groß genug ist, oder die erforderliche Größe des Ausgabepuffers. Wenn keine CPU-Sätze vorhanden sind, ist dieser Wert 0.

Process

Ein optionales Handle für einen Prozess. Dieser Prozess wird verwendet, um den Wert des AllocatedToTargetProcess-Flags in der SYSTEM_CPU_SET_INFORMATION-Struktur zu bestimmen. Wenn dem angegebenen Prozess ein CPU-Satz zugeordnet ist, wird das Flag festgelegt. Andernfalls ist es eindeutig. Dieses Handle muss über das zugriffsrecht PROCESS_QUERY_LIMITED_INFORMATION verfügen. Der von GetCurrentProcess zurückgegebene Wert kann hier ebenfalls angegeben werden.

Flags

Reserviert, muss 0 sein.

Rückgabewert

Wenn die API erfolgreich ist, wird TRUE zurückgegeben. Wenn ein Fehler auftritt, ist die Fehlerursache über GetLastError verfügbar. Wenn der Informationspuffer NULL oder nicht groß genug war, wird der Fehlercode ERROR_INSUFFICIENT_BUFFER zurückgegeben. Diese API kann nicht fehlschlagen, wenn gültige Parameter und ein Puffer übergeben werden, der groß genug ist, um alle Rückgabedaten zu enthalten.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10
Unterstützte Mindestversion (Server)	WIndows Server 2016
Kopfzeile	processthreadsapi.h