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 Variable vom Typ KAFFINITY, die die neue Systemaffinität des aktuellen Threads angibt.
Rückgabewert
Keine
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 unter 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 unter IRQL = DISPATCH_LEVEL aufgerufen wird und der Aufruf erfolgreich ist, wird die ausstehende Prozessoränderung zurückgestellt, bis der Aufrufer den IRQL unter DISPATCH_LEVEL senkt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (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 | Universell |
| Header | wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL (siehe Abschnitt Hinweise). |
| DDI-Complianceregeln | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |