DIF_NEWDEVICEWIZARD_PRESELECT

Article
06/14/2023

Une demande de DIF_NEWDEVICEWIZARD_PRESELECT permet à un programme d’installation de fournir des pages de l’Assistant que Windows affiche à l’utilisateur avant d’afficher la page select-driver. 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é la classe pour l’appareil, mais avant que Windows affiche la page « Sélectionner un pilote de périphérique ».

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 le SP_NEWDEVICEWIZARD_DATA pour fournir une ou plusieurs 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 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

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 co-programme d’installation peut ajouter des pages personnalisées dans son pass de prétraitement et/ou dans son pass post-traitement. S’il ajoute la ou les pages dans son passage de prétraitement, ces pages s’affichent avant toute page fournie par le programme d’installation de la classe.

Si un ou plusieurs programmes d’installation ajoutent des pages de présélection personnalisées, Windows affiche les pages avant la page « Sélectionner un pilote de périphérique ». Toutefois, si l’utilisateur appuie sur « Retour » sur la page select-driver, Windows ignore les pages de présélection personnalisées et retourne à la page de sélection de classe « Type de matériel ».

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.