IoQueueWorkItemEx-Funktion (wdm.h)

Artikel
02/27/2024

Die IoQueueWorkItemEx-Routine ordnet eine WorkItemEx-Routine einem Arbeitselement zu und fügt das Arbeitselement zur späteren Verarbeitung durch einen Systemarbeitsthread in eine Warteschlange ein.

Syntax

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 zugeordnet oder von IoInitializeWorkItem initialisiert wurde.

[in] WorkerRoutine

Zeiger auf eine WorkItemEx-Routine .

[in] QueueType

Gibt einen WORK_QUEUE_TYPE Wert an, der den Typ des Systemarbeitsthreads angibt, der das Arbeitselement verarbeiten soll. Treiber müssen DelayedWorkQueue angeben.

[in, optional] Context

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

Rückgabewert

Keine

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 das Arbeitselement bereitstellt.

Weitere Informationen zu Arbeitselementen finden Sie unter System Workerthreads.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und späteren Windows-Versionen.
Zielplattform	Universell
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL

Weitere Informationen