Fonction IoQueueWorkItemEx (wdm.h)

Article
02/29/2024

La routine IoQueueWorkItemEx associe une routine WorkItemEx à un élément de travail et insère l’élément de travail dans une file d’attente pour un traitement ultérieur par un thread de travail système.

Syntaxe

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

Paramètres

[in] IoWorkItem

Pointeur vers une structure IO_WORKITEM allouée par IoAllocateWorkItem ou initialisée par IoInitializeWorkItem.

[in] WorkerRoutine

Pointeur vers une routine WorkItemEx .

[in] QueueType

Spécifie une valeur WORK_QUEUE_TYPE qui spécifie le type de thread worker système pour gérer l’élément de travail. Les pilotes doivent spécifier DelayedWorkQueue.

[in, optional] Context

Spécifie des informations spécifiques au pilote pour l’élément de travail. Le système transmet cette valeur en tant que paramètre Context à WorkItemEx.

Valeur de retour

None

Remarques

La routine IoQueueWorkItemEx diffère d’IoQueueWorkItem en ce que le paramètre WorkerRoutine est un pointeur vers une routine de rappel WorkItemEx , qui fournit au pilote un pointeur vers la structure IO_WORKITEM pour l’élément de travail.

Pour plus d’informations sur les éléments de travail, consultez Threads de travail système.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows Vista et les versions plus récentes de Windows.
Plateforme cible	Universal
En-tête	wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL

Voir aussi