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

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	processtopologyapi.h (einschließen von Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

GetProcessGroupAffinity

Prozessorgruppen