DIF_NEWDEVICEWIZARD_SELECT

Article
06/15/2023

Une demande de DIF_NEWDEVICEWIZARD_SELECT permet à un programme d’installation de fournir une ou plusieurs pages d’Assistant personnalisées qui remplacent la page select-driver standard. Cette demande n’est utilisée que lors de l’installation manuelle d’appareils non PnP.

Date d’envoi

Immédiatement avant que Windows n’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

Un programme d’installation répond à cette demande DIF pour remplacer complètement la page de l’Assistant select-driver standard. Si, au lieu de cela, le programme d’installation doit uniquement modifier la page standard ou modifier la liste des pilotes à partir desquels choisir, le programme d’installation doit le faire en réponse à la demande DIF_SELECTDEVICE .

Un co-programme d’installation doit ajouter la ou les pages personnalisées dans sa passe post-traitement et uniquement si le programme d’installation de classe n’a pas ajouté de pages personnalisées. Si le programme d’installation de classe a ajouté la ou les pages, le co-programme d’installation ne doit pas. Sinon, l’utilisateur peut être invité à choisir un pilote deux fois.

Si un programme d’installation fournit une page de sélection personnalisée, le programme d’installation doit définir le pilote sélectionné. Dans le code du programme d’installation qui prend en charge la page de l’Assistant, une fois que l’utilisateur clique sur Suivant, le programme d’installation doit appeler SetupDiSetSelectedDriver.

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.