IWDFDevice3 ::CreateWorkItem, méthode (wudfddi.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 méthode CreateWorkItem crée un objet d’élément de travail d’infrastructure, qui peut ensuite être ajouté à la file d’attente d’éléments de travail de l’infrastructure.
Syntaxe
HRESULT CreateWorkItem(
[in] PWUDF_WORKITEM_CONFIG pConfig,
[in, optional] IWDFObject *pParentObject,
[out] IWDFWorkItem **ppWorkItem
);
Paramètres
[in] pConfig
Pointeur vers une structure WUDF_WORKITEM_CONFIG allouée par l’appelant que le pilote doit déjà initialiser en appelant WUDF_WORKITEM_CONFIG_INIT.
[in, optional] pParentObject
Pointeur vers l’interface d’objet parent ou NULL.
[out] ppWorkItem
Pointeur vers une mémoire tampon qui reçoit un pointeur vers l’interface IWDFWorkItem pour le nouvel objet WorkItem.
Valeur de retour
La méthode retourne S_OK si l’opération réussit. Sinon, cette méthode retourne l’un des codes d’erreur définis dans Winerror.h.
Remarques
Si vous spécifiez un objet parent, l’infrastructure supprime automatiquement l’élément de travail lorsque l’objet parent est supprimé. Le pilote peut également appeler IWDFObject ::D eleteWdfObject pour supprimer un élément de travail. Le pilote ne doit pas supprimer un élément de travail dans son OnWorkItem fonction de rappel.
Pour plus d’informations, consultez Utilisation des éléments de travail.
Exemples
WUDF_WORKITEM_CONFIG config;
WUDF_WORKITEM_CONFIG_INIT(&config, OnWorkItem);
hr = m_IWdfDevice3->CreateWorkItem(&config,
m_IWdfDevice3,
&m_WorkItem);
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 | wudfddi.h |
| DLL | WUDFx.dll |