KeSetSystemAffinityThread-Funktion (wdm.h)
Die KeSetSystemAffinityThread Routine legt die Systemaffinität des aktuellen Threads fest.
Syntax
void KeSetSystemAffinityThread(
[in] KAFFINITY Affinity
);
Parameter
[in] Affinity
Eine KAFFINITY-typd Variable, die die neue Systemaffinität des aktuellen Threads angibt.
Rückgabewert
Nichts
Bemerkungen
Die Implementierung von KeSetSystemAffinityThread- in Windows 7 und höheren Versionen von Windows bietet Kompatibilität für Treiber, die für frühere Versionen von Windows geschrieben wurden, die keine Prozessorgruppen unterstützen. In dieser Implementierung weist KeSetSystemAffinityThread den Thread der Gruppe 0 zu und verwendet die Affinitätsmaske, um einen Satz logischer Prozessoren in dieser Gruppe anzugeben, auf dem der Thread ausgeführt werden kann.
Wenn KeSetSystemAffinityThread- bei IRQL <= APC_LEVEL aufgerufen wird und der Aufruf erfolgreich ist, wird die neue Affinitätsmaske sofort wirksam. Wenn der Aufruf zurückgegeben wird, wird der aufrufende Thread bereits auf einem Prozessor ausgeführt, der in der neuen Affinitätsmaske angegeben ist. Wenn KeSetSystemAffinityThread- bei IRQL = DISPATCH_LEVEL aufgerufen wird und der Anruf erfolgreich ist, wird die ausstehende Prozessoränderung zurückgestellt, bis der Aufrufer die IRQL unter DISPATCH_LEVEL verringert.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows 2000 und höheren Versionen von Windows. Verwenden Sie KeSetSystemAffinityThread nur auf Systemen vor Windows Vista. Verwenden Sie in Windows Vista und höheren Versionen des Windows-Betriebssystems stattdessen KeSetSystemAffinityThreadEx. |
| Zielplattform- | Universal |
| Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | <= DISPATCH_LEVEL (siehe Abschnitt "Hinweise"). |
| DDI-Complianceregeln | HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm) |