WUDF_WORKITEM_FUNCTION fonction de rappel (wudfworkitem.h)

  • Article

[Avertissement : UMDF 2 est la dernière version d’UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide d’UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et la prise en charge d’UMDF 1 est limitée sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Prise en main avec UMDF.]

La fonction de rappel d’événement OnWorkItem d’un pilote effectue le travail associé à un élément de travail spécifié.

Syntaxe

WUDF_WORKITEM_FUNCTION WudfWorkitemFunction;

void WudfWorkitemFunction(
  [in] IWDFWorkItem *pWorkItem
)
{...}

Paramètres

[in] pWorkItem

Pointeur vers une interface IWDFWorkItem .

Valeur de retour

None

Remarques

Pour inscrire une fonction de rappel OnWorkItem , votre pilote doit placer l’adresse de la fonction de rappel dans une structure WUDF_WORKITEM_CONFIG avant d’appeler IWDFDevice3 ::CreateWorkItem.

En règle générale, la fonction de rappel OnWorkItem d’un pilote effectue des tâches qui sont spécifiées par les informations stockées par le pilote dans la mémoire contextuelle d’un objet d’élément de travail.

Le pilote ne doit pas appeler IWDFObject ::D eleteWdfObject à partir de la fonction de rappel OnWorkItem .

Pour plus d’informations, consultez Utilisation d’éléments de travail.

Exemples

Le type de fonction est déclaré dans Wudfworkitem.h, comme suit.

typedef
VOID
WUDF_WORKITEM_FUNCTION(
    _In_
    IWDFWorkItem* pWorkItem
    );

typedef WUDF_WORKITEM_FUNCTION *PFN_WUDF_WORKITEM;

Pour définir une fonction de rappel OnWorkItem nommée MyWorkItem, vous devez d’abord fournir une déclaration de fonction dont SDV et d’autres outils de vérification ont besoin, comme suit :

WUDF_WORKITEM_FUNCTION  MyWorkItem;

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

VOID
  MyWorkItem (
   _In_
    IWDFWorkItem* pWorkItem
    )
  {…}

Configuration requise

Condition requise Valeur
Fin de la prise en charge Non disponible dans UMDF 2.0 et versions ultérieures.
Plateforme cible Desktop (Expérience utilisateur)
Version UMDF minimale 1.11
En-tête wudfworkitem.h

Voir aussi

IWDFDevice3 ::CreateWorkItem

IWDFObject ::D eleteWdfObject

WUDF_WORKITEM_CONFIG