GetSystemCpuSetInformation-Funktion

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

Syntax

BOOL WINAPI GetSystemCpuSetInformation(
  _Out_opt_  PSYSTEM_CPU_SET_INFORMATION  Information,
  _In_       ULONG                        BufferLength,
  _Out_      PULONG                       ReturnedLength,
  _In_opt_   HANDLE                       Process,
  _Reserved_ ULONG                        Flags
);

Parameter

Informationen [out, optional]

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 [in]

Die Länge des Ausgabepuffers in Bytes, die als Information-Argument übergeben wird.

ReturnedLength [out]

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.

Prozess [in, optional]

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 auch hier angegeben werden.

Flags

Reserviert, muss 0 sein.

Rückgabewert

Wenn die API erfolgreich ist, gibt sie TRUE zurück. Wenn ein Fehler auftritt, ist der Fehlergrund ü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 zurückgegebenen Daten aufzunehmen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [Desktop-Apps | UWP-Apps]
Header	Processthreadsapi.h
Bibliothek	Windows.h
DLL	Kernel32.dll