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)

Weitere Informationen

KAFFINITY

KeSetSystemAffinityThreadEx