Fonctions qui simplifient l'installation des pilotes

Une application d’installation peut utiliser les fonctions suivantes pour simplifier l’installation d’un package de pilotes PnP.

DiInstallDevice (Windows Vista et versions ultérieures de Windows)

La fonction DiInstallDevice installe un package de pilotes spécifique préinstallé dans le magasin de pilotes sur un appareil spécifique présent dans le système.

Une application d’installation ne doit utiliser cette fonction que si les deux éléments suivants sont vrais :

• L’application intègre plusieurs instances d’appareil du même type, c’est-à-dire que toutes les instances d’appareil ont les mêmes ID matériels et id compatibles.

• L’application exige que les packages de pilotes spécifiques à l’instance d’appareil soient installés sur les instances d’appareil.

Sinon, une application d’installation doit utiliser DiInstallDriver ou UpdateDriverForPlugAndPlayDevices pour installer le package de pilotes qui correspond le mieux à un appareil.

Un appelant peut également appeler DiInstallDevice pour effectuer les opérations suivantes :

• Recherchez un package de pilotes préinstallé qui correspond le mieux à l’appareil.

• Installez un pilote Null sur un appareil spécifique.

• Informez l’appelant si un redémarrage du système est nécessaire pour terminer l’installation.

DiInstallDriver (Windows Vista et versions ultérieures de Windows)

La fonction DiInstallDriver préinstalle un package de pilotes dans le Magasin des pilotes, puis installe le package de pilotes sur tous les appareils présents dans le système qui ont un ID matériel ou un ID compatible qui correspond au package de pilotes.

L’appel de DiInstallDriver ou UpdateDriverForPlugAndPlayDevices est le moyen le plus simple pour une application d’installation d’installer un nouveau package de pilotes pour un appareil. DiInstallDriver et UpdateDriverForPlugAndPlayDevices effectuent les mêmes opérations d’installation de base. Toutefois , UpdateDriverForPlugAndPlayDevices prend en charge des options d’installation supplémentaires.

Par défaut, DiInstallDriver installe uniquement le package de pilotes sur un appareil si le package de pilotes est mieux adapté à l’appareil que le package de pilotes actuellement installé sur l’appareil. Pour plus d’informations sur la façon dont Windows sélectionne un package de pilotes pour l’appareil, consultez Comment Windows sélectionne les pilotes.

Un appelant peut également appeler DiInstallDriver pour effectuer les opérations suivantes :

• Forcez l'installation du package de pilotes spécifié, peu importe si ce package est mieux adapté à l'appareil que celui actuellement installé sur celui-ci.

  Prudence Forcer l’installation du package de pilotes peut entraîner le remplacement d’un package de pilotes plus compatible ou plus récent par un package de pilotes moins compatible ou plus ancien.

• Indiquez à l’appelant si un redémarrage du système est nécessaire pour terminer l’installation.

DiRollbackDriver (Windows Vista et versions ultérieures de Windows)

La fonction DiRollbackDriver remplace le package de pilotes actuellement installé sur un appareil par le package de pilotes de sauvegarde précédemment installé défini pour un appareil. Cette fonction est fournie principalement pour restaurer un appareil dans une condition de travail si un appareil échoue après la mise à jour du package de pilotes pour l’appareil. Cette fonction effectue la même opération que si un utilisateur a cliqué sur Restaurer le pilote sur la page Pilote de l’appareil dans Le Gestionnaire de périphériques.

Windows gère au plus un package de pilotes de sauvegarde pour un appareil. Windows définit un package de pilotes comme pilote de sauvegarde pour un appareil immédiatement après l’installation du package de pilotes sur l’appareil et Windows détermine que l’appareil fonctionne correctement. Toutefois, si un package de pilotes ne s’installe pas correctement sur un appareil ou si l’appareil ne fonctionne pas correctement après l’installation, Windows ne définit pas le package de pilotes comme pilote de sauvegarde pour l’appareil.

Un appelant peut également appeler DiRollbackDriver pour effectuer les opérations suivantes :

• Supprimez l’affichage de tout composant d’interface utilisateur associé à la rétrogradation du pilote.

• Indiquez à l’appelant si un redémarrage du système est nécessaire pour terminer l’installation.

Pour plus d’informations sur la restauration du package de pilotes, consultez les informations relatives au Gestionnaire de périphériques dans le Centre d’aide et de support.

UpdateDriverForPlugAndPlayDevices

La fonction UpdateDriverForPlugAndPlayDevices installe le package de pilotes sur tous les appareils présents dans le système qui ont un ID matériel ou un ID compatible qui correspond au package de pilotes.

L’appel de cette fonction ou DiInstallDriver est le moyen le plus simple pour une application d’installation d’installer un nouveau package de pilotes qui correspond le mieux aux appareils du système. L’opération de base de UpdateDriverForPlugAndPlayDevices est similaire à l’opération de DiInstallDriver. Toutefois , UpdateDriverForPlugAndPlayDevices prend en charge des options d’installation supplémentaires.

Par défaut, UpdateDriverForPlugAndPlayDevices installe uniquement le package de pilotes sur un appareil si le package de pilotes est mieux adapté à l’appareil que le package de pilotes actuellement installé sur un appareil.

Un appelant peut également appeler UpdateDriverForPlugAndPlayDevices pour effectuer les opérations suivantes :

• Forcez l'installation du paquet de pilotes spécifié, peu importe si ce paquet est mieux adapté à l'appareil que celui actuellement installé sur l'appareil.

  Prudence Forcer l’installation du package de pilotes peut entraîner le remplacement d’un package de pilotes plus compatible ou plus récent par un package de pilotes moins compatible ou plus ancien.

• Supprimez la copie, le renommage ou la suppression de fichiers d’installation.

• Supprimez l’affichage des composants d’interface utilisateur.

• Indiquez à l’appelant si un redémarrage du système est nécessaire pour terminer l’installation.