Méthode IWDFObject ::D eleteWdfObject (wudfddi.h)

[Avertissement : UMDF 2 est la dernière version d’UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide d’UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et la prise en charge d’UMDF 1 est limitée sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Prise en main avec UMDF.]

La méthode DeleteWdfObject supprime un objet WDF (Microsoft Windows Driver Frameworks) créé précédemment.

Syntaxe

HRESULT DeleteWdfObject();

Valeur de retour

DeleteWdfObject retourne S_OK si l’opération réussit. Sinon, cette méthode retourne HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED) ou l’un des autres codes d’erreur définis dans Winerror.h.

Remarques

Un pilote ne peut pas supprimer certains objets WDF. Par exemple, le pilote ne peut pas supprimer un objet d’appareil framework , car l’infrastructure possède et contrôle les objets d’appareil. Pour plus d’informations sur la hiérarchie des objets WDF, consultez Hiérarchie d’objets Framework.

Le pilote supprime généralement uniquement les objets WDF qu’il crée et possède. Pour plus d’informations sur la suppression d’objets framework, consultez Gestion de la durée de vie des objets.

Toutefois, lorsqu’un objet parent est supprimé, tous les objets enfants sont automatiquement supprimés. Par exemple, si le pilote a appelé IWDFDevice ::CreateIoQueue pour créer un objet file d’attente d’E/S, la file d’attente d’E/S nouvellement créée devient un enfant de l’objet d’appareil. L’objet file d’attente d’E/S est ensuite automatiquement supprimé lorsque l’objet d’appareil est supprimé sans que le pilote appelle explicitement DeleteWdfObject.

Exemples

Pour obtenir un exemple de code expliquant comment utiliser la méthode DeleteWdfObject , consultez IWDFDevice ::SetPnpState.

Configuration requise

Condition requise	Valeur
Fin de la prise en charge	Non disponible dans UMDF 2.0 et versions ultérieures.
Plateforme cible	Desktop (Expérience utilisateur)
Version UMDF minimale	1.5
En-tête	wudfddi.h (inclure Wudfddi.h)
DLL	WUDFx.dll

Voir aussi

IWDFDevice ::CreateIoQueue

IWDFObject