SetThreadGroupAffinity-Funktion (processtopologyapi.h)

  • Artikel

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

Siehe auch

GROUP_AFFINITY