IPnpCallbackHardware2 ::OnPrepareHardware, 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 OnPrepareHardware effectue toutes les opérations nécessaires pour rendre un appareil accessible au pilote.

Syntaxe

HRESULT OnPrepareHardware(
  [in] IWDFDevice3        *pWdfDevice,
  [in] IWDFCmResourceList *pWdfResourcesRaw,
  [in] IWDFCmResourceList *pWdfResourcesTranslated
);

Paramètres

[in] pWdfDevice

Pointeur vers l’interface IWDFDevice3 pour l’objet d’appareil framework.

[in] pWdfResourcesRaw

Pointeur vers l’interface IWDFCmResourceList pour l’objet de liste de ressources du framework qui identifie les ressources matérielles brutes que le gestionnaire de Plug-and-Play a attribuées à l’appareil.

[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

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

Si OnPrepareHardware retourne un code d’erreur, l’infrastructure appelle toujours la méthode IPnpCallbackHardware2 ::OnReleaseHardware . La méthode OnReleaseHardware peut ensuite libérer les ressources qui ont été allouées lors de l’appel à OnPrepareHardware. Étant donné qu’OnReleaseHardware doit libérer des ressources pour les cas de réussite et d’échec de OnPrepareHardware, OnReleaseHardware doit être en mesure de gérer le nettoyage des ressources partielles.

Remarques

La méthode IPnpCallbackHardware2 ::OnPrepareHardware diffère de la méthode IPnpCallbackHardware ::OnPrepareHardware en ce qu’elle reçoit des ressources brutes et traduites.

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

Voir aussi

IPnpCallbackHardware2

OnReleaseHardware