IPnpCallbackHardware2 ::OnReleaseHardware, méthode (wudfddi.h)

  • Article

[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

Voir aussi

IPnpCallbackHardware2

OnPrepareHardware