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 work-item framework obtenu à partir d’un appel précédent à WdfWorkItemCreate.
Valeur de retour
WdfWorkItemGetParentObject retourne un handle à l’objet framework spécifié comme 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 Using Framework Work Items.
Exemples
L’exemple de code suivant est une fonction de rappel EvtWorkItem à partir 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 élément de travail.
VOID
t1394_BusResetRoutineWorkItem(
IN WDFWORKITEM WorkItem
)
{
WDFDEVICE Device = WdfWorkItemGetParentObject(WorkItem);
t1394_UpdateGenerationCount(Device);
WdfObjectDelete(WorkItem);
}
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| version minimale de KMDF | 1.0 |
| version minimale de UMDF | 2.0 |
| d’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) |