IoQueueWorkItemEx-Funktion (wdm.h)

Artikel
07.02.2025

Die IoQueueWorkItemEx Routine ordnet eine WorkItemEx Routine einer Arbeitsaufgabe zu und fügt die Arbeitsaufgabe zur späteren Verarbeitung durch einen Systemarbeitsthread in eine Warteschlange ein.

Syntax

C++

void IoQueueWorkItemEx(
  [in]           __drv_aliasesMem PIO_WORKITEM IoWorkItem,
  [in]           PIO_WORKITEM_ROUTINE_EX       WorkerRoutine,
  [in]           WORK_QUEUE_TYPE               QueueType,
  [in, optional] __drv_aliasesMem PVOID        Context
);

Parameter

[in] IoWorkItem

Zeiger auf eine IO_WORKITEM Struktur, die von IoAllocateWorkItem- oder initialisiert von IoInitializeWorkItemzugewiesen wurde.

[in] WorkerRoutine

Zeiger auf eine WorkItemEx Routine.

[in] QueueType

Gibt einen WORK_QUEUE_TYPE Wert an, der den Typ des Systemarbeitsthreads für die Verarbeitung der Arbeitsaufgabe angibt. Treiber müssen DelayedWorkQueueangeben.

[in, optional] Context

Gibt treiberspezifische Informationen für die Arbeitsaufgabe an. Das System übergibt diesen Wert als Context-Parameter an WorkItemEx.

Rückgabewert

Nichts

Bemerkungen

Die IoQueueWorkItemEx Routine unterscheidet sich von IoQueueWorkItem darin, dass der WorkerRoutine Parameter ein Zeiger auf eine WorkItemEx Rückrufroutine ist, die dem Treiber einen Zeiger auf die IO_WORKITEM Struktur für die Arbeitsaufgabe bereitstellt.

Weitere Informationen zu Arbeitsaufgaben finden Sie unter System Worker Threads.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows Vista und höheren Versionen von Windows.
Zielplattform-	Universal
Header-	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe
IRQL-	<= DISPATCH_LEVEL