Fonction KeSetSystemAffinityThread (wdm.h)
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) |