Méthode IPnpCallbackHardware ::OnPrepareHardware (wudfddi.h)

Article
03/01/2024

[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 avertit un pilote de rendre le matériel spécifié accessible.

Syntaxe

HRESULT OnPrepareHardware(
  [in] IWDFDevice *pWdfDevice
);

Paramètres

[in] pWdfDevice

Pointeur vers l’interface IWDFDevice pour que l’objet d’appareil de l’appareil soit accessible.

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 IPnpCallbackHardware ::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, il doit être en mesure de gérer le nettoyage des ressources partielles.

Cette méthode doit utiliser la macro HRESULT_FROM_NT pour retourner une valeur HRESULT spécifique afin de renvoyer status à 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 lorsqu’il appelle la méthode IWDFDriver ::CreateDevice pour créer un objet d’appareil.

La réception d’un appel à la méthode OnPrepareHardware équivaut à un pilote WDM (Microsoft Windows Driver Model) recevant un IRP IRP_MN_START_DEVICE .

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