GetThreadGroupAffinity-Funktion (processtopologyapi.h)

Ruft die Prozessorgruppenaffinität des angegebenen Threads ab.

Syntax

BOOL GetThreadGroupAffinity(
  [in]  HANDLE          hThread,
  [out] PGROUP_AFFINITY GroupAffinity
);

Parameter

[in] hThread

Ein Handle für den Thread, für den die Prozessorgruppenaffinität gewünscht wird.

Das Handle muss über das THREAD_QUERY_INFORMATION- oder THREAD_QUERY_LIMITED_INFORMATION-Zugriffsrecht verfügen. Weitere Informationen finden Sie unter Threadsicherheit und Zugriffsrechte.

[out] GroupAffinity

Ein Zeiger auf eine GROUP_AFFINITY Struktur, um die Gruppenaffinität des Threads zu empfangen.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Verwenden Sie GetLastError, um erweiterte Fehlerinformationen abzurufen.

Hinweise

Ab Windows 11 und Windows Server 2022 umfassen Prozess- und Threadaffinitäten auf einem System mit mehr als 64 Prozessoren standardmäßig alle Prozessoren im System, und zwar über alle Prozessorgruppen hinweg. Die GetThreadGroupAffinity-Funktion ruft die Gruppenaffinität gegenüber der primären Gruppe des Threads ab.

Um eine Anwendung zu kompilieren, die diese Funktion verwendet, legen Sie _WIN32_WINNT >= 0x0601 fest. Weitere Informationen finden Sie unter Verwenden der Windows-Header.

Anforderungen

Siehe auch

GetProcessGroupAffinity

Prozessorgruppen