WdfWorkItemGetParentObject, fonction (wdfworkitem.h)

Article
02/27/2024

[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 pour un objet d’élément de travail d’infrastructure obtenu à partir d’un appel précédent à WdfWorkItemCreate.

Valeur retournée

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

Un bogue case activée 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 d’infrastructure.

Exemples

L’exemple de code suivant est une fonction de rappel EvtWorkItem de l’exemple de pilote 1394 . L’exemple obtient l’objet d’appareil 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 élément de travail.

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

    t1394_UpdateGenerationCount(Device);

    WdfObjectDelete(WorkItem);
}

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
Version KMDF minimale	1.0
Version UMDF minimale	2.0
En-tête	wdfworkitem.h (include 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

Partager via