Fonctions qui simplifient l’installation du pilote

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 instance d’appareil du même type, c’est-à-dire que toutes les instances d’appareil ont les mêmes ID matériels et les mêmes ID compatibles.

• L’application nécessite que les packages de pilotes spécifiques instance périphérique 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 de 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 le package de pilotes sur un appareil uniquement si le package de pilotes correspond mieux à 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é, que le package de pilotes corresponde mieux au périphérique que le package de pilotes actuellement installé sur l’appareil.

  Attention 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é qui est défini pour un appareil. Cette fonction est principalement fournie pour restaurer un appareil en état de fonctionnement en cas de défaillance d’un appareil après la mise à jour du package de pilotes pour l’appareil. Cette fonction effectue la même opération que celle qui serait effectuée si un utilisateur cliquait sur Restaurer le pilote dans la page Pilote de l’appareil dans Gestionnaire de périphériques.

Windows gère au maximum 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 que le package de pilotes a été correctement installé sur l’appareil et que Windows détermine que le périphérique 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 le périphérique.

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

• Supprimez l’affichage de tout composant d’interface utilisateur associé à la restauration 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 des informations sur 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 de 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 le package de pilotes sur un appareil uniquement si le package de pilotes correspond mieux au périphérique 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 package de pilotes spécifié, que le package de pilotes corresponde mieux au périphérique que le package de pilotes actuellement installé sur l’appareil.

  Attention 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 des fichiers d’installation.

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

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