DIF_TROUBLESHOOTER
La demande DIF_TROUBLESHOOTER permet à un programme d’installation de démarrer un utilitaire de résolution des problèmes pour un appareil ou de retourner des fichiers de résolution des problèmes CHM et HTM pour le démarrage de Windows.
Note Ce code DIF est uniquement pris en charge sur Windows Server 2003, Windows XP et Microsoft Windows 2000.
Date d’envoi
Lorsqu’un utilisateur clique sur le bouton « Utilitaire de résolution des problèmes » pour un appareil dans Gestionnaire de périphériques.
Qui gère
Co-programme d’installation de classe |
Peut gérer |
Co-programme d’installation d’appareil |
Peut gérer |
Programme d’installation de classe |
Peut gérer |
Entrée du programme d’installation
DeviceInfoSet
Fournit un handle au jeu d’informations de l’appareil qui contient l’appareil.
DeviceInfoData
Fournit un pointeur vers une structure de SP_DEVINFO_DATA qui identifie l’appareil dans le jeu d’informations sur l’appareil.
Paramètres d’installation de l’appareil
Des paramètres d’installation d’appareil (SP_DEVINSTALL_PARAMS) sont associés à DeviceInfoData.
Paramètres d’installation de classe
Une structure SP_TROUBLESHOOTER_PARAMS est associée à DeviceInfoData.
Sortie du programme d’installation
Paramètres d’installation de classe
Un programme d’installation peut modifier le SP_TROUBLESHOOTER_PARAMS en définissant un fichier CHM ou HTML.
Valeur de retour du programme d’installation
Si un co-programme d’installation ne gère pas cette requête, il retourne NO_ERROR de son passe de prétraitement.
Si un co-programme d’installation gère cette requête, il le fait dans sa passe de post-traitement. Si le co-programme d’installation fournit des fichiers CHM et HTML, il propage les status qu’il a reçus (probablement ERROR_DI_DO_DEFAULT). Si le co-programme d’installation exécute un utilitaire de résolution des problèmes et résout le problème, le co-programme d’installation retourne NO_ERROR. Si le co-programme d’installation exécute un utilitaire de résolution des problèmes mais ne résout pas le problème, il propage le status qu’il a reçu (ERROR_DI_DO_DEFAULT).
Si un programme d’installation de classe fournit un fichier CHM et un fichier HTML, ou si le programme d’installation de classe exécute un utilitaire de résolution des problèmes, mais ne résout pas le problème, le programme d’installation de classe retourne ERROR_DI_DO_DEFAULT. Windows appellera par la suite le gestionnaire par défaut.
Si un programme d’installation de classe démarre son propre utilitaire de résolution des problèmes et résout le problème, le programme d’installation de classe retourne NO_ERROR. Windows n’appellera pas par la suite le gestionnaire par défaut.
Si le programme d’installation de classe rencontre une erreur, le programme d’installation retourne un code d’erreur Win32 approprié. Windows n’appellera pas par la suite le gestionnaire par défaut.
Gestionnaire de code DIF par défaut
None
Il n’existe aucun gestionnaire par défaut pour les DIF_TROUBLESHOOTER, mais le système d’exploitation fournit des utilitaires de résolution des problèmes par défaut qui tentent de résoudre les problèmes d’appareil s’il n’existe aucun utilitaire de résolution des problèmes fourni par le programme d’installation.
Opération du programme d’installation
Un programme d’installation appelle CM_Get_DevNode_Status pour obtenir le status de l’appareil et le code du problème CM. Selon le problème, un programme d’installation peut fournir un utilitaire de résolution des problèmes, un fichier d’aide ou rien. Un utilitaire de résolution des problèmes peut éventuellement résoudre un problème avec un appareil. Si un utilitaire de résolution des problèmes résout le problème, il doit appeler SetupDiCallClassInstaller pour envoyer une requête DIF_PROPERTYCHANGE de type DICS_PROPCHANGE. Si un programme d’installation ne fournit pas d’utilitaire de résolution des problèmes pour un appareil, il peut fournir un fichier d’aide contenant des suggestions de résolution des problèmes pour l’utilisateur.
Si aucun programme d’installation n’exécute son propre utilitaire de résolution des problèmes, Windows exécute l’aide HTML pour afficher des informations à l’utilisateur. Si un programme d’installation a fourni un fichier CHM dans les paramètres d’installation de classe, Windows affiche ce fichier. Sinon, Windows affiche des informations de résolution des problèmes fournies par le système.
Les paramètres d’installation de classe contiennent au plus une paire ChmFile et HtmlTroubleShooter . Si plusieurs programmes d’installation spécifient ces valeurs, Windows utilise les valeurs définies par le dernier programme d’installation qui a géré la requête DIF.
Pour plus d’informations sur les codes DIF, consultez Gestion des codes DIF.
Spécifications
Version |
Pris en charge dans Windows Server 2003, Windows XP et Microsoft Windows 2000. |
En-tête |
Setupapi.h (inclure Setupapi.h) |