GetProcessDefaultCpuSets-Funktion (processthreadsapi.h)

Ruft die Liste der CPU-Sätze im Prozessstandardsatz ab, der von SetProcessDefaultCpuSets festgelegt wurde. Wenn für einen bestimmten Prozess keine STANDARD-CPU-Sätze festgelegt sind, wird RequiredIdCount auf 0 festgelegt, und die Funktion ist erfolgreich.

Syntax

BOOL GetProcessDefaultCpuSets(
  HANDLE Process,
  PULONG CpuSetIds,
  ULONG  CpuSetIdCount,
  PULONG RequiredIdCount
);

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

CpuSetIds

Gibt einen optionalen Puffer an, um die Liste der CPU-Satzbezeichner abzurufen.

CpuSetIdCount

Gibt die Kapazität des in CpuSetIds angegebenen Puffers an. Wenn der Puffer NULL ist, muss dies 0 sein.

RequiredIdCount

Gibt die erforderliche Kapazität des Puffers an, um die gesamte Liste der Prozessstandard-CPU-Sätze zu enthalten. Bei erfolgreicher Rückgabe gibt dies die Anzahl der IDs an, die in den Puffer gefüllt werden.

Rückgabewert

Diese API gibt BEI Erfolg TRUE zurück. Wenn der Puffer nicht groß genug ist, gibt die API FALSE zurück, und der GetLastError-Wert ist ERROR_INSUFFICIENT_BUFFER. Diese API kann nicht fehlschlagen, wenn gültige Parameter übergeben werden und der Rückgabepuffer groß genug ist.

Anforderungen