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) |