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 Thread Security and Access Rights.
[out] GroupAffinity
Ein Zeiger auf eine GROUP_AFFINITY-Struktur, die die Gruppenaffinität des Threads empfängt.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, verwenden Sie GetLastError-.
Bemerkungen
Ab Windows 11 und Windows Server 2022 umfasst ein System mit mehr als 64 Prozessoren, Prozess- und Threadaffinitäten alle Prozessoren im System, über alle Prozessorgruppenstandardmäßig. Die GetThreadGroupAffinity-funktion ruft die Gruppenaffinität über die primäre 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 |
|---|---|
| mindestens unterstützte Client- | Windows 7 [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2008 R2 [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | processtopologyapi.h (include Windows.h) |
| Library | Kernel32.lib |
| DLL- | Kernel32.dll |