ExQueueWorkItem-Funktion (wdm.h)

Artikel
03/08/2023

ExQueueWorkItem fügt ein bestimmtes Arbeitselement in eine Warteschlange ein, aus der ein Systemarbeitsthread das Element entfernt, und gibt der Routine die Kontrolle, die der Aufrufer für ExInitializeWorkItem bereitgestellt hat.

Warnung

Verwenden Sie diese Routine mit äußerster Vorsicht. Weitere Informationen finden Sie weiter unten im Abschnitt "Hinweise ".

Syntax

void ExQueueWorkItem(
  [in, out] __drv_aliasesMem PWORK_QUEUE_ITEM WorkItem,
  [in]      WORK_QUEUE_TYPE                   QueueType
);

Parameter

[in, out] WorkItem

Zeiger auf das Arbeitselement. Dieses Arbeitselement muss durch einen vorherigen Aufruf von ExInitializeWorkItem initialisiert worden sein.

[in] QueueType

Gibt die Warteschlange an, in die das Arbeitselement eingefügt werden soll, auf das von WorkItem verwiesen wird. QueueType kann eine der folgenden Optionen sein:

Wert	Bedeutung
CriticalWorkQueue	Fügen Sie das WorkItem in die Warteschlange ein, aus der ein Systemthread mit einem Echtzeitprioritätsattribut das Arbeitselement verarbeitet.
DelayedWorkQueue	Fügen Sie das WorkItem in die Warteschlange ein, aus der ein Systemthread mit einem Variablenprioritätsattribut das Arbeitselement verarbeitet.

Der QueueType-WertHyperCriticalWorkQueue ist für die Systemverwendung reserviert.

Rückgabewert

Keine

Bemerkungen

Gerätetreiber müssen IoQueueWorkItem anstelle von ExQueueWorkItem verwenden. Treiber sollten ExQueueWorkItem und das zugeordnete ExInitializeWorkItem nur in Fällen verwenden, in denen das angegebene Arbeitselement keinem Geräteobjekt oder Gerätestapel zugeordnet ist. In allen anderen Fällen sollten Treiber IoAllocateWorkItem, IoFreeWorkItem und IoQueueWorkItem verwenden, da nur diese Routinen sicherstellen, dass das dem angegebenen Arbeitselement zugeordnete Geräteobjekt verfügbar bleibt, bis das Arbeitselement verarbeitet wurde.

Die Rückrufroutine, die im Routine-Parameter für ExInitializeWorkItem angegeben wurde, wird in einem Systemkontext bei IRQL PASSIVE_LEVEL aufgerufen. Diese vom Aufrufer bereitgestellte Routine ist dafür verantwortlich, das Arbeitselement freizugeben, wenn es nicht mehr benötigt wird, indem ExFreePool oder ExFreePoolWithTag aufgerufen wird.

Systemworkerthreads sind eine begrenzte Ressource. Fahrer dürfen ein Arbeitselement nicht dauerhaft für den Fahrer reservieren. Arbeitselemente sind für Vorgänge konzipiert, die schnell abgeschlossen werden. Treiber sollten alle Arbeitselemente, die sie zuordnen, so bald wie möglich freigeben.

Ein Treiber darf nicht warten, bis seine Rückrufroutine einen Vorgang abgeschlossen hat, wenn er bereits ein Synchronisierungsobjekt enthält und möglicherweise versucht, ein anderes abzurufen. Um deadlocks zu verhindern, sollte ein Treiber alle derzeit gehaltenen Semaphore, Mutexe, Ressourcenvariablen usw. freigeben, bevor ExQueueWorkItem aufgerufen wird.

Der Wert von QueueType bestimmt die Laufzeitpriorität, mit der die Rückrufroutine wie folgt ausgeführt wird:

Wenn der Rückruf im Systemthread mit einem Prioritätsattribut in Echtzeit ausgeführt wird, kann die Rückrufroutine nur durch Threads mit höheren Echtzeitprioritäten vorzeitig entfernt werden.
Wenn der Rückruf im Systemthread mit einem Attribut mit variabler Priorität ausgeführt wird, kann der Rückruf von Threads mit höheren Variablen- und Echtzeitprioritäten vorzeitig entfernt werden, und der Rückruf wird für die Ausführung eines Roundrobins mit anderen Threads mit der gleichen Priorität für jeweils ein Quantum geplant.

Threads mit beiden Prioritäten bleiben unterbrechungsfähig.

Anforderungen

Anforderung	Wert
Zielplattform	Universell
Header	wdm.h (include Wdm.h, Ntifs.h, Fltkernel.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	IRQL <= DISPATCH_LEVEL