DIF_NEWDEVICEWIZARD_PREANALYZE
Une demande de DIF_NEWDEVICEWIZARD_PREANALYZE permet à un programme d’installation de fournir des pages d’Assistant que Windows affiche à l’utilisateur avant d’afficher la page d’analyse. Cette demande n’est utilisée que lors de l’installation manuelle d’appareils non PnP.
Date d’envoi
Une fois que l’utilisateur a sélectionné un pilote, mais avant que Windows inscrive l’appareil qui rend le nœud d’appareil (devnode) « actif ».
Qui gère
Co-programme d’installation de classe |
Peut gérer |
Co-programme d’installation d’appareil |
Ne gère pas |
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 SP_DEVINFO_DATA qui identifie l’appareil dans le jeu d’informations de 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_NEWDEVICEWIZARD_DATA est associée à DeviceInfoData.
Sortie du programme d’installation
Paramètres d’installation de l’appareil
Un programme d’installation peut modifier les indicateurs dans les paramètres d’installation de l’appareil. Windows ne case activée pas les indicateurs une fois cette demande DIF terminée. Toutefois, il les vérifie plus tard dans le processus d’installation.
Paramètres d’installation de classe
Un programme d’installation peut modifier les SP_NEWDEVICEWIZARD_DATA pour fournir une ou plusieurs pages d’Assistant personnalisées.
Valeur de retour du programme d’installation
Si un co-programme d’installation ne gère pas cette demande DIF, il retourne NO_ERROR de sa passe de prétraitement. Si un co-programme d’installation gère cette demande, il peut retourner NO_ERROR, ERROR_DI_POSTPROCESSING_REQUIRED ou un code d’erreur Win32.
Un programme d’installation de classe retourne NO_ERROR s’il fournit correctement la ou les pages. Sinon, un programme d’installation de classe retourne ERROR_DI_DO_DEFAULT ou un code d’erreur Win32.
Gestionnaire de code DIF par défaut
None
Opération du programme d’installation
Une demande de DIF_NEWDEVICEWIZARD_PREANALYZE permet à un programme d’installation de fournir des pages d’Assistant que Windows affiche à l’utilisateur avant d’afficher la page d’analyse. Ces pages peuvent être considérées comme des pages « postselect ». Cette demande n’est utilisée que lors de l’installation manuelle d’appareils non PnP.
Un programme d’installation peut utiliser une page de préanalyse personnalisée, par exemple, pour choisir un port COM après l’sélection d’un périphérique modem.
Si un programme d’installation ajoute des pages de présélection personnalisées, le programme d’installation doit d’abord case activée si NumDynamicPages dans les paramètres d’installation de classe a atteint MAX_INSTALLWIZARD_DYNAPAGES.
Un programme d’installation doit fournir un titre d’en-tête Assistant 97 et un sous-titre d’en-tête dans la structure PROPSHEETPAGE pour une page d’Assistant personnalisée. Un programme d’installation ne doit pas remplacer le titre de l’Assistant fourni par le système. Consultez la Microsoft Windows SDK pour obtenir de la documentation sur la structure PROPSHEETPAGE et pour plus d’informations sur les pages de propriétés.
Pour plus d’informations sur les codes DIF, consultez Gestion des codes DIF.
Spécifications
Version |
Pris en charge dans Microsoft Windows 2000 et versions ultérieures de Windows. |
En-tête |
Setupapi.h (inclure Setupapi.h) |