IPnpCallbackHardware2 ::OnPrepareHardware, méthode (wudfddi.h)
[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 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 de l’infrastructure qui identifie les ressources matérielles brutes affectées par le gestionnaire Plug-and-Play à l’appareil.
[in] pWdfResourcesTranslated
Pointeur vers l’interface IWDFCmResourceList pour l’objet de liste de ressources framework qui identifie les ressources matérielles traduites que le gestionnaire Plug-and-Play a attribuées à l’appareil.
Valeur de retour
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 alors libérer des ressources allouées pendant l’appel à OnPrepareHardware. Étant donné que 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 dans laquelle elle reçoit des ressources brutes et traduites.
Pour plus d’informations sur l’analyse des ressources matérielles, consultez Recherche et mappage des ressources matérielles dans unpilote UMDF.
Exemples
Consultez un exemple de code dans IWDFDevice3 ::MapIoSpace.
Exigences
| Exigence | Valeur |
|---|---|
| fin du support | Indisponible dans UMDF 2.0 et versions ultérieures. |
| plateforme cible | Bureau |
| version minimale de UMDF | 1.11 |
| d’en-tête | wudfddi.h |