Partager via


WUDF_WORKITEM_FUNCTION fonction de rappel (wudfworkitem.h)

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

La fonction de rappel d’événement OnWorkItem du 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

Aucun

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, le OnWorkItem d’un pilote fonction de rappel effectue des tâches spécifiées par les informations que le pilote a stockées 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 des é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 que SDV et d’autres outils de vérification nécessitent, comme suit :

WUDF_WORKITEM_FUNCTION  MyWorkItem;

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

VOID
  MyWorkItem (
   _In_
    IWDFWorkItem* pWorkItem
    )
  {…}

Exigences

Exigence Valeur
fin du support Indisponible dans UMDF 2.0 et versions ultérieures.
plateforme cible Bureau
version minimale de UMDF 1.11
d’en-tête wudfworkitem.h

Voir aussi

IWDFDevice3 ::CreateWorkItem

IWDFObject ::D eleteWdfObject

WUDF_WORKITEM_CONFIG