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 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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour