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

Article
02/07/2025

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

La méthode OnReleaseHardware avertit un pilote d’effectuer des opérations nécessaires lorsque le matériel spécifié n’est plus accessible.

Syntaxe

HRESULT OnReleaseHardware(
  [in] IWDFDevice *pWdfDevice
);

Paramètres

[in] pWdfDevice

Pointeur vers l’interface IWDFDevice pour l’objet d’appareil de l’appareil qui n’est plus accessible.

Valeur de retour

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).

Cette méthode doit utiliser la macro HRESULT_FROM_NT pour retourner une valeur HRESULT spécifique pour retourner l’état à un client en mode noyau. Pour plus d’informations, consultez Prise en charge des clients en mode noyau.

Remarques

Un pilote inscrit l’interface IPnpCallbackHardware lorsque le pilote appelle la méthode IWDFDriver ::CreateDevice pour créer un objet d’appareil.

La méthode OnReleaseHardware doit libérer des ressources qui ont été allouées pendant l’appel au IPnpCallbackHardware ::OnPrepareHardware méthode si OnPrepareHardware réussi ou échoué. Par conséquent, OnReleaseHardware doit être en mesure de gérer le nettoyage des ressources partielles.

Pour plus d’informations, consultez Recherche et mappage de ressources matérielles dans un pilote UMDF.