fonction de rappel IO_WORKITEM_ROUTINE_EX (wdm.h)

Article
07/02/2025

Une routine WorkItemEx effectue le traitement d’un élément de travail mis en file d’attente par la routine IoQueueWorkItemEx ou routine IoTryQueueWorkItem.

Syntaxe

C++

IO_WORKITEM_ROUTINE_EX IoWorkitemRoutineEx;

void IoWorkitemRoutineEx(
  [in]           PVOID IoObject,
  [in, optional] PVOID Context,
  [in]           PIO_WORKITEM IoWorkItem
)
{...}

Paramètres

[in] IoObject

Pointeur vers l’objet de pilote de l’appelant ou vers l’un des objets d’appareil de l’appelant. Il s’agit du pointeur passé en tant que paramètre DeviceObject à IoAllocateWorkItem lorsque l’élément de travail a été alloué, ou en tant que paramètre IoObject à IoInitializeWorkItem ou IoTryQueueWorkItem lors de l’initialisation de l’élément de travail.

[in, optional] Context

Spécifie des informations de contexte spécifiques au pilote. Il s’agit de la valeur passée en tant que paramètre Context à IoQueueWorkItemEx ou IoTryQueueWorkItem lorsque l’élément de travail a été mis en file d’attente.

[in] IoWorkItem

Pointeur vers la structure IO_WORKITEM de l’élément de travail. Il s’agit du pointeur passé en tant que paramètre IoWorkItem à IoQueueWorkItemEx ou IoTryQueueWorkItem.

Valeur de retour

Aucun

Remarques

Les pilotes peuvent implémenter Routines WorkItemEx uniquement sur Windows Vista et les versions ultérieures de Windows.

Le pilote met en file d’attente une routine WorkItemEx en appelant IoQueueWorkItemEx ou IoTryQueueWorkItem, et un thread de travail système exécute ensuite la routine. Pour plus d’informations, consultez threads de travail système.

Une routine WorkItemEx doit s’exécuter pendant une durée limitée ; sinon, le système peut s’interblocer. Pour plus d’informations, consultez threads de travail système.

Une routine WorkItemEx s’exécute à IRQL = PASSIVE_LEVEL et dans un contexte de thread système.

Exemples

Pour définir une routine de rappel WorkItemEx, vous devez d’abord fournir une déclaration de fonction qui identifie le type de routine de rappel que vous définissez. Windows fournit un ensemble de types de fonctions de rappel pour les pilotes. La déclaration d’une fonction à l’aide des types de fonctions de rappel permet d'Analyse du code pour les pilotes, static Driver Verifier (SDV) et d’autres outils de vérification recherchent des erreurs, et il est nécessaire d’écrire des pilotes pour le système d’exploitation Windows.

Par exemple, pour définir une routine de rappel WorkItemEx nommée MyWorkItemEx, utilisez le type IO_WORKITEM_ROUTINE_EX comme indiqué dans cet exemple de code :

C++

IO_WORKITEM_ROUTINE_EX MyWorkItemEx;

Ensuite, implémentez votre routine de rappel comme suit :

C++

_Use_decl_annotations_
VOID
  MyWorkItemEx(
    PVOID  IoObject,
    PVOID  Context,
    PIO_WORKITEM  IoWorkItem 
    )
  {
      // Function body
  }

Le type de fonction IO_WORKITEM_ROUTINE_EX est défini dans le fichier d’en-tête Wdm.h. Pour identifier plus précisément les erreurs lorsque vous exécutez les outils d’analyse du code, veillez à ajouter l’annotation _Use_decl_annotations_ à votre définition de fonction. L’annotation _Use_decl_annotations_ garantit que les annotations appliquées au type de fonction IO_WORKITEM_ROUTINE_EX dans le fichier d’en-tête sont utilisées. Pour plus d’informations sur les exigences relatives aux déclarations de fonction, consultez déclaration de fonctions à l’aide de types de rôles de fonction pour les pilotes WDM. Pour plus d’informations sur _Use_decl_annotations_, consultez annoter le comportement de la fonction.