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 |