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 |