IWDFDevice3 ::CreateWorkItem, méthode (wudfddi.h)

Article
03/01/2024

[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 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 de WUDF_WORKITEM_CONFIG allouée par l’appelant que le pilote doit déjà avoir initialisée 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 retournée

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 sa fonction de rappel OnWorkItem .

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

Exemples

WUDF_WORKITEM_CONFIG config;
        
WUDF_WORKITEM_CONFIG_INIT(&config, OnWorkItem); 
hr = m_IWdfDevice3->CreateWorkItem(&config,
                                   m_IWdfDevice3,   
                                   &m_WorkItem);

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	wudfddi.h
DLL	WUDFx.dll