GetThreadSelectedCpuSets-Funktion (processthreadsapi.h)

Gibt die explizite CPU-Satzzuweisung des angegebenen Threads zurück, wenn eine Zuweisung mithilfe der SetThreadSelectedCpuSets-API festgelegt wurde. Wenn keine explizite Zuweisung festgelegt ist, wird RequiredIdCount auf 0 festgelegt, und die Funktion gibt TRUE zurück.

Syntax

BOOL GetThreadSelectedCpuSets(
  HANDLE Thread,
  PULONG CpuSetIds,
  ULONG  CpuSetIdCount,
  PULONG RequiredIdCount
);

Parameter

Thread

Gibt den Thread an, für den die ausgewählten CPU-Sätze abfragt werden sollen. Dieses Handle muss über das THREAD_QUERY_LIMITED_INFORMATION-Zugriffsrecht verfügen. Der von GetCurrentThread zurückgegebene Wert kann auch hier 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 ausgewählten Thread-CPU-Sätze zu enthalten. Bei erfolgreicher Rückgabe gibt dies die Anzahl der IDs an, die in den Puffer eingegeben wurden.

Rückgabewert

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

Anforderungen