SetThreadAffinityMask, fonction (winbase.h)

Article
03/03/2024

Définit un masque d’affinité processeur pour le thread spécifié.

Syntaxe

DWORD_PTR SetThreadAffinityMask(
  [in] HANDLE    hThread,
  [in] DWORD_PTR dwThreadAffinityMask
);

Paramètres

[in] hThread

Handle pour le thread dont le masque d’affinité doit être défini.

Ce handle doit avoir le droit d’accès THREAD_SET_INFORMATION ou THREAD_SET_LIMITED_INFORMATION et le droit d’accès THREAD_QUERY_INFORMATION ou THREAD_QUERY_LIMITED_INFORMATION . Pour plus d’informations, consultez Sécurité des threads et droits d’accès.

Windows Server 2003 et Windows XP : Le handle doit disposer des droits d’accès THREAD_SET_INFORMATION et THREAD_QUERY_INFORMATION .

[in] dwThreadAffinityMask

Masque d’affinité pour le thread.

Sur un système avec plus de 64 processeurs, le masque d’affinité doit spécifier les processeurs dans le groupe de processeurs actuel du thread.

Valeur retournée

Si la fonction réussit, la valeur de retour est le masque d’affinité précédent du thread.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Si le masque d’affinité de thread demande un processeur qui n’est pas sélectionné pour le masque d’affinité de processus, le dernier code d’erreur est ERROR_INVALID_PARAMETER.

Remarques

Un masque d’affinité de thread est un vecteur de bits dans lequel chaque bit représente un processeur logique sur lequel un thread est autorisé à s’exécuter. Un masque d’affinité de thread doit être un sous-ensemble du masque d’affinité de processus pour le processus conteneur d’un thread. Un thread ne peut s’exécuter que sur les processeurs sur 10000. Par conséquent, le masque d’affinité de thread ne peut pas spécifier un 1 bit pour un processeur lorsque le masque d’affinité de processus spécifie un 0 bit pour ce processeur.

La définition d’un masque d’affinité pour un processus ou un thread peut entraîner la réception de threads moins de temps processeur, car le système n’est pas autorisé à exécuter les threads sur certains processeurs. Dans la plupart des cas, il est préférable de laisser le système sélectionner un processeur disponible.

Si le nouveau masque d’affinité de thread ne spécifie pas le processeur qui exécute actuellement le thread, le thread est replanifié sur l’un des processeurs autorisés.

À compter de Windows 11 et Windows Server 2022, sur un système avec plus de 64 processeurs, les affinités de processus et de thread couvrent tous les processeurs du système, sur tous les groupes de processeurs, par défaut. DwThreadAffinityMask doit spécifier des processeurs dans le groupe principal actuel du thread.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	winbase.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll