WdfWorkItemGetParentObject, fonction (wdfworkitem.h)

[S’applique à KMDF et à UMDF]

La méthode WdfWorkItemGetParentObject retourne l’objet framework auquel un élément de travail spécifié est associé.

Syntaxe

WDFOBJECT WdfWorkItemGetParentObject(
  [in] WDFWORKITEM WorkItem
);

Paramètres

[in] WorkItem

Handle vers un objet d’élément de travail d’infrastructure obtenu à partir d’un appel précédent à WdfWorkItemCreate.

Valeur de retour

WdfWorkItemGetParentObject retourne un handle à l’objet framework que le pilote spécifié en tant que membre ParentObject de la structure WDF_OBJECT_ATTRIBUTES du pilote lorsque le pilote a précédemment appelé WdfWorkItemCreate.

Une vérification de bogue se produit si le pilote fournit un handle d’objet non valide.

Remarques

Pour plus d’informations sur les éléments de travail, consultez Utilisation des éléments de travail Framework.

Exemples

L’exemple de code suivant est une fonction de rappel EvtWorkItem de l’exemple de pilote 1394 . L’exemple obtient l’objet de périphérique parent d’un élément de travail, appelle une routine définie par le pilote pour traiter l’élément de travail, puis supprime l’objet d’élément de travail.

VOID
t1394_BusResetRoutineWorkItem(
    IN WDFWORKITEM  WorkItem
)
{
    WDFDEVICE  Device = WdfWorkItemGetParentObject(WorkItem);

    t1394_UpdateGenerationCount(Device);

    WdfObjectDelete(WorkItem);
}

Configuration requise

   
Plateforme cible Universal
Version KMDF minimale 1.0
Version UMDF minimale 2,0
En-tête wdfworkitem.h (inclure Wdf.h)
Bibliothèque Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
Règles de conformité DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Voir aussi

WDF_OBJECT_ATTRIBUTES

WdfWorkItemCreate