KeSetTargetProcessorDpcEx-Funktion (wdm.h)

Artikel
02/29/2024

Die KeSetTargetProcessorDpcEx-Routine gibt den Prozessor an, auf dem eine DPC-Routine ausgeführt wird.

Syntax

NTSTATUS KeSetTargetProcessorDpcEx(
  [in, out] PKDPC             Dpc,
  [in]      PPROCESSOR_NUMBER ProcNumber
);

Parameter

[in, out] Dpc

Ein Zeiger auf das DPC-Objekt des Aufrufers. Dieser Parameter verweist auf eine KDPC-Struktur , bei der es sich um eine undurchsichtige Systemstruktur handelt, die das DPC-Objekt darstellt. Dieses Objekt muss zuvor von der KeInitializeDpc-Routine initialisiert worden sein.

[in] ProcNumber

Ein Zeiger auf eine vom Aufrufer zugewiesene PROCESSOR_NUMBER Struktur, die den Zielprozessor identifiziert, in dem der DPC in die Warteschlange gestellt und ausgeführt wird. Diese Struktur gibt eine Gruppe und einen Prozessor innerhalb dieser Gruppe an.

Rückgabewert

KeSetTargetProcessorDpcEx gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich ist. Andernfalls wird Folgendes zurückgegeben:

Rückgabecode	Beschreibung
STATUS_INVALID_PARAMETER	Der ProcNumber-Parameter verweist auf eine ungültige Prozessornummer.

Hinweise

Jeder Prozessor in einem Multiprozessorsystem verfügt über eine eigene DPC-Warteschlange. KeSetTargetProcessorDpcEx gibt an, welche Prozessorwarteschlange das System verwenden soll, wenn der Treiber die KeInsertQueueDpc - oder IoRequestDpc-Routine aufruft, um eine DPC-Warteschlange für die spätere Ausführung in die Warteschlange zu stellen.

KeSetTargetProcessorDpcEx kann den Zielprozessor sowohl für normale DPCs als auch für Thread-DPCs angeben. Ein gewöhnlicher DPC kann nicht einmal durch einen Thread mit hoher Priorität vorenthalten werden, aber ein threadbasierter DPC kann durch zeitkritische Threads mit ausreichend hohen Prioritäten vorenthalten werden.

Eine verwandte Routine, KeSetTargetProcessorDpc, gibt einen Zielprozessor für einen DPC an, aber diese Routine gibt im Gegensatz zu KeSetTargetProcessorDpcEx keine Gruppe für den Zielprozessor an. Ab Windows 7 geht KeSetTargetProcessorDpc davon aus, dass der Zielprozessor zur Gruppe 0 gehört. Dieses Verhalten stellt sicher, dass vorhandene Treiber, die KeSetTargetProcessorDpc aufrufen und keine gruppenorientierten Features verwenden, in Multiprozessorsystemen mit zwei oder mehr Gruppen ordnungsgemäß ausgeführt werden. Treiber, die gruppenorientierte Features in Windows 7 und höheren Versionen des Windows-Betriebssystems verwenden, sollten jedoch KeSetTargetProcessorDpcEx anstelle von KeSetTargetProcessorDpc aufrufen.

Ein Aufruf von KeSetTargetProcessorDpcEx , der erfolgt, nachdem ein DPC-Objekt in die Warteschlange gestellt wurde, hat keine Auswirkungen auf die Auswahl eines Prozessors für die Ausführung der DPC-Routine. Um die Auswahl des Zielprozessors zu steuern, muss ein KeSetTargetProcessorDpcEx-Aufruf vor dem Aufruf von KeInsertQueueDpc oder IoRequestDpc erfolgen, der das DPC-Objekt in die Warteschlange stellt.

Weitere Informationen zu DPC-Warteschlangen finden Sie unter Organisation von DPC-Warteschlangen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 7.
Zielplattform	Universell
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	Beliebige Ebene