Fonction KeSetSystemAffinityThread (wdm.h)

  • Article

La routine KeSetSystemAffinityThread définit l’affinité système du thread actuel.

Syntaxe

void KeSetSystemAffinityThread(
  [in] KAFFINITY Affinity
);

Paramètres

[in] Affinity

Variable de type KAFFINITY qui spécifie la nouvelle affinité système du thread actuel.

Valeur de retour

None

Remarques

L’implémentation de KeSetSystemAffinityThread dans Windows 7 et versions ultérieures de Windows fournit la compatibilité pour les pilotes qui ont été écrits pour les versions antérieures de Windows, qui ne prennent pas en charge les groupes de processeurs. Dans cette implémentation, KeSetSystemAffinityThread affecte le thread au groupe 0 et utilise le masque d’affinité pour spécifier un ensemble de processeurs logiques dans ce groupe sur lesquels le thread peut s’exécuter.

Si KeSetSystemAffinityThread est appelé au niveau IRQL <= APC_LEVEL et que l’appel réussit, le nouveau masque d’affinité prend effet immédiatement. Lorsque l’appel est retourné, le thread appelant est déjà en cours d’exécution sur un processeur spécifié dans le nouveau masque d’affinité. Si KeSetSystemAffinityThread est appelé à l’adresse IRQL = DISPATCH_LEVEL et que l’appel réussit, le changement de processeur en attente est différé jusqu’à ce que l’appelant abaisse l’IRQL sous DISPATCH_LEVEL.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows 2000 et versions ultérieures de Windows. Utilisez KeSetSystemAffinityThread uniquement sur les systèmes antérieurs à Windows Vista. Dans Windows Vista et les versions ultérieures du système d’exploitation Windows, utilisez KeSetSystemAffinityThreadEx à la place.
Plateforme cible Universal
En-tête wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL (voir la section Remarques).
Règles de conformité DDI HwStorPortProhibitedDDIs(storport),PowerIrpDDis(wdm)

Voir aussi

KAFFINITY

KeSetSystemAffinityThreadEx