SetThreadGroupAffinity-Funktion (processtopologyapi.h)
Legt die Prozessorgruppenaffinität für den angegebenen Thread fest.
Syntax
BOOL SetThreadGroupAffinity(
[in] HANDLE hThread,
[in] const GROUP_AFFINITY *GroupAffinity,
[out, optional] PGROUP_AFFINITY PreviousGroupAffinity
);
Parameter
[in] hThread
Ein Handle auf den Thread.
Das Handle muss über das THREAD_SET_INFORMATION-Zugriffsrecht verfügen. Weitere Informationen finden Sie unter Threadsicherheit und Zugriffsrechte.
[in] GroupAffinity
Eine GROUP_AFFINITY-Struktur , die die Prozessorgruppenaffinität angibt, die für den angegebenen Thread verwendet werden soll.
[out, optional] PreviousGroupAffinity
Ein Zeiger auf eine GROUP_AFFINITY Struktur, um die vorherige Gruppenaffinität des Threads zu empfangen. Dieser Parameter kann NULL sein.
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 auf einem System mit mehr als 64 Prozessoren standardmäßig Prozess- und Threadaffinitäten alle Prozessoren im System, und das über alle Prozessorgruppen hinweg. Die SetThreadGroupAffinity-Funktion schränkt die Affinität eines Threads zu den Prozessoren über die einzelne Prozessorgruppe ein, die von der angegebenen GroupAffinity angegeben wird. Diese Gruppe wird auch zur primären Gruppe des Threads.
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 |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |