KeSetSystemAffinityThread, fonction (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 KAFFINITY-typée qui spécifie la nouvelle affinité système du thread actuel.
Valeur de retour
Aucun
Remarques
L’implémentation de KeSetSystemAffinityThread dans Windows 7 et versions ultérieures de Windows fournit la compatibilité pour les pilotes é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 lequel le thread peut s’exécuter.
Si KeSetSystemAffinityThread est appelé à 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é à IRQL = DISPATCH_LEVEL et que l’appel réussit, la modification du processeur en attente est différée jusqu’à ce que l’appelant diminue le runtime d’intégration sous DISPATCH_LEVEL.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows 2000 et versions ultérieures de Windows. Utilisez KeSetSystemAffinityThread uniquement sur les systèmes avant Windows Vista. Dans Windows Vista et versions ultérieures du système d’exploitation Windows, utilisez KeSetSystemAffinityThreadEx à la place. |
| plateforme cible | Universel |
| d’en-tête | wdm.h (include 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) |