Funzione IoQueueWorkItemEx (wdm.h)

Articolo
08/08/2023

La routine IoQueueWorkItemEx associa una routine WorkItemEx a un elemento di lavoro e inserisce l'elemento di lavoro in una coda per un'elaborazione successiva da parte di un thread di lavoro di sistema.

Sintassi

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
);

Parametri

[in] IoWorkItem

Puntatore a una struttura IO_WORKITEM allocata da IoAllocateWorkItem o inizializzata da IoInitializeWorkItem.

[in] WorkerRoutine

Puntatore a una routine WorkItemEx .

[in] QueueType

Specifica un valore WORK_QUEUE_TYPE che stabilisce il tipo di thread di lavoro di sistema per gestire l'elemento di lavoro. I driver devono specificare DelayedWorkQueue.

[in, optional] Context

Specifica le informazioni specifiche del driver per l'elemento di lavoro. Il sistema passa questo valore come parametro Context a WorkItemEx.

Valore restituito

nessuno

Osservazioni

La routine IoQueueWorkItemEx differisce da IoQueueWorkItem in quanto il parametro WorkerRoutine è un puntatore a una routine di callback WorkItemEx , che fornisce al driver un puntatore alla struttura IO_WORKITEM per l'elemento di lavoro.

Per altre informazioni sugli elementi di lavoro, vedere Thread di lavoro di sistema.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive di Windows.
Piattaforma di destinazione	Universale
Intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL