Partager via

Appel des gestionnaires de code DIF par défaut

  • Article

Notes

Les fonctionnalités décrites dans cette section ne sont pas prises en charge dans les packages de pilotes universels ou mobiles. Consultez Utilisation d’un fichier INF universel.

Les gestionnaires de code DIF par défaut effectuent des opérations par défaut définies par le système pour les codes DIF. Comme décrit dans Gestion des codes DIF, SetupDiCallClassInstaller appelle le gestionnaire par défaut pour une requête DIF une fois que le programme d’installation de classe et le co-programme d’installation ont d’abord traité la requête DIF, mais avant SetupDiCallClassInstaller rappelle les co-programmes d’installation inscrits pour le post-traitement de la demande.

Note L’opération de SetupDiCallClassInstaller ne peut pas être configurée pour rappeler le programme d’installation de classe pour post-traiter une demande DIF.

Dans les situations où un programme d’installation de classe doit effectuer des opérations pour une requête DIF après l’appel du gestionnaire par défaut, le programme d’installation de classe doit appeler directement le gestionnaire par défaut lorsqu’il traite la requête DIF, comme suit :

  1. Effectuez des opérations qui doivent être effectuées avant d’appeler le gestionnaire par défaut.

  2. Appelez le gestionnaire par défaut pour effectuer les opérations par défaut.

    Note Le programme d’installation de classe ne doit pas tenter de remplacer l’opération du gestionnaire par défaut.

  3. Effectuez les opérations qui doivent être effectuées après le retour du gestionnaire par défaut.

  4. Retournez NO_ERROR si le programme d’installation de classe a réussi à traiter la demande DIF ou retourne une erreur Win32 si le traitement a échoué.

Important Lesco-programmes d’installation et lesapplications d’installation d’appareil ne doivent pas appeler les gestionnaires de code DIF par défaut.

Pour obtenir un exemple de situation dans laquelle cette méthode doit être utilisée, consultez les informations relatives à l’appel du gestionnaire par défaut SetupDiInstallDevice dans la page de référence de la demande DIF_INSTALLDEVICE .

Le tableau suivant répertorie les codes DIF qui ont des gestionnaires par défaut.

Code DIF Fonction de gestionnaire de code DIF par défaut
DIF_PROPERTYCHANGE SetupDiChangeState
DIF_FINISHINSTALL_ACTION SetupDiFinishInstallAction
DIF_INSTALLDEVICE SetupDiInstallDevice
DIF_INSTALLINTERFACES SetupDiInstallDeviceInterfaces
DIF_INSTALLDEVICEFILES SetupDiInstallDriverFiles
DIF_REGISTER_COINSTALLERS SetupDiRegisterCoDeviceInstallers
DIF_REGISTERDEVICE SetupDiRegisterDeviceInfo
DIF_REMOVE SetupDiRemoveDevice
DIF_SELECTBESTCOMPATDRV SetupDiSelectBestCompatDrv
DIF_SELECTDEVICE SetupDiSelectDevice
DIF_UNREMOVE SetupDiUnremoveDevice