IDriverEntry ::OnDeviceAdd, 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 OnDeviceAdd ajoute un nouvel appareil à un système.

Syntaxe

HRESULT OnDeviceAdd(
  [in] IWDFDriver           *pWdfDriver,
  [in] IWDFDeviceInitialize *pWdfDeviceInit
);

Paramètres

[in] pWdfDriver

Pointeur vers l’interface IWDFDriver pour l’objet de pilote parent auquel appartient le nouvel appareil.

[in] pWdfDeviceInit

Pointeur vers l’interface IWDFDeviceInitialize que le pilote utilise pour initialiser l’appareil nouvellement créé.

Valeur de retour

OnDeviceAdd 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. Le pilote doit retourner S_OK uniquement s’il a appelé correctement la méthode IWDFDriver ::CreateDevice pour créer l’objet d’appareil de l’infrastructure . Si le pilote retourne un code d’erreur, UMDF supprime l’ensemble de la pile d’appareils, que le pilote soit un pilote de filtre ou un pilote de fonction.

Remarques

Un nouvel objet d’appareil est créé pour chaque appareil chargé dans le processus hôte du pilote. Lorsqu’un nouvel appareil arrive dans le système, le framework appelle OnDeviceAdd pour avertir le pilote de l’arrivée et passer le IWDFDriver et IWDFDeviceInitialize interfaces dans l’appel. Le pilote peut appeler la méthode IWDFDeviceInitialize ::RetrieveDevicePropertyStore pour rechercher les informations d’appareil fournies dans le cadre de l’installation de l’appareil. Le pilote doit appeler la méthode IWDFDriver ::CreateDevice pour configurer et créer l’appareil. Si le pilote n’appelle pas correctement IWDFDriver ::CreateDevice avant de retourner S_OK, UMDF détermine que le comportement du pilote est incorrect et met fin au processus hôte.

Tout pilote dont la méthode OnDeviceAdd retourne S_OK reçoit par la suite un appel à son IPnpCallbackHardware ::OnReleaseHardware méthode lorsque la fonction UMDF supprime la pile d’appareils.

N’utilisez pas l’interface IWDFDeviceInitialize que le paramètre pWdfDeviceIn it pointe vers une fois que le pilote a appelé IWDFDriver ::CreateDevice.

Pour plus d’informations, consultez Ajout d’un appareil.