IPnpCallbackHardware2 ::OnReleaseHardware, méthode (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 OnReleaseHardware effectue les opérations nécessaires lorsqu’un appareil n’est plus accessible.
Syntaxe
HRESULT OnReleaseHardware(
[in] IWDFDevice3 *pWdfDevice,
[in] IWDFCmResourceList *pWdfResourcesTranslated
);
Paramètres
[in] pWdfDevice
Pointeur vers l’interface IWDFDevice3 pour l’objet d’appareil framework.
[in] pWdfResourcesTranslated
Pointeur vers l’interface IWDFCmResourceList pour l’objet de liste de ressources du framework qui identifie les ressources matérielles traduites que le gestionnaire de Plug-and-Play a attribuées à l’appareil.
Valeur retournée
OnReleaseHardware retourne S_OK si l’opération réussit. Sinon, cette méthode retourne l’un des codes d’erreur définis dans Winerror.h. Ne retournez pas HRESULT_FROM_NT(STATUS_NOT_SUPPORTED).
Remarques
Un pilote inscrit l’interface IPnpCallbackHardware2 lorsque le pilote appelle la méthode IWDFDriver ::CreateDevice pour créer un objet d’appareil.
La méthode OnReleaseHardware doit libérer les ressources qui ont été allouées pendant l’appel à la méthode IPnpCallbackHardware2 ::OnPrepareHardware du pilote, que l’onPrepareHardware ait réussi ou échoué. Par conséquent, OnReleaseHardware doit être en mesure de gérer le nettoyage des ressources partielles.
Pour plus d’informations sur la suppression d’un objet d’interruption, consultez Suppression d’un objet d’interruption.
Pour plus d’informations sur l’analyse des ressources matérielles, consultez Recherche et mappage de ressources matérielles dans un pilote UMDF.
Exemples
Consultez l’exemple de code dans IWDFDevice3 ::MapIoSpace.
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.11 |
| En-tête | wudfddi.h |