DIF_NEWDEVICEWIZARD_POSTANALYZE
Une demande de DIF_NEWDEVICEWIZARD_POSTANALYZE permet à un programme d’installation de fournir des pages d’Assistant que Windows affiche à l’utilisateur après l’inscription du nœud d’appareil (devnode), mais avant que Windows installe les pilotes de l’appareil. Cette requête est utilisée uniquement lors de l’installation manuelle d’appareils non PnP.
Date d’envoi
Après que Windows a inscrit l’appareil, ce qui rend le devnode « actif », mais avant que Windows installe les pilotes de l’appareil.
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 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_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 à la fin de cette demande DIF. Toutefois, il les case activée plus tard dans le processus d’installation.
Paramètres d’installation de classe
Un programme d’installation peut modifier le SP_NEWDEVICEWIZARD_DATA pour fournir des pages 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 son 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_POSTANALYZE permet à un programme d’installation de fournir des pages d’Assistant que Windows affiche à l’utilisateur après l’inscription du devnode, mais avant que Windows installe les pilotes de l’appareil. Cette requête est utilisée uniquement lors de l’installation manuelle d’appareils non PnP.
Si un programme d’installation ajoute des pages postanalyze 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.
Une fois que l’utilisateur a cliqué sur Suivant sur une page personnalisée, Windows installe les pilotes de l’appareil et le gestionnaire PnP démarre l’appareil. Une page de l’Assistant postanalyze est la dernière occasion pour un programme d’installation d’effectuer un travail avant le chargement des pilotes et le démarrage de l’appareil.
Un programme d’installation doit fournir un titre d’en-tête Wizard 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) |