DIF_INSTALLDEVICEFILES

Article
06/15/2023

Une demande de DIF_INSTALLDEVICEFILES permet à un programme d’installation de participer à la copie des fichiers pour prendre en charge un appareil ou d’effectuer une liste des fichiers pour un appareil. Les fichiers d’appareil incluent des fichiers pour le pilote sélectionné, toutes les interfaces d’appareil et tous les co-programmes d’installation.

Date d’envoi

Les composants d’installation d’appareil fournis par le système envoient cette demande DIF pour diverses raisons. Certains composants d’installation d’appareil envoient cette demande DIF avant DIF_REGISTER_COINSTALLERS, DIF_INSTALLINTERFACES et DIF_INSTALL_DEVICE pour s’assurer que tous les fichiers pertinents peuvent être copiés avant de poursuivre l’installation. Certains composants d’installation d’appareil omettent cette demande DIF et s’attendent à ce que les fichiers soient copiés pendant la gestion de ces trois demandes DIF. En outre, certains composants d’installation d’appareil envoient cette demande DIF pour récupérer la liste des fichiers associés à un 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 sur l’appareil qui contient l’appareil dont les fichiers de prise en charge doivent être copiés.

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.

Si l’indicateur DI_NOVCP est défini, les paramètres d’installation de l’appareil contiennent un handle FileQueue valide et les programmes d’installation qui gèrent cette demande DIF ajoutent leurs opérations de fichier à cette file d’attente et ne valident pas la file d’attente.

Paramètres d’installation de classe
None

Sortie du programme d’installation

Paramètres d’installation de l’appareil
Un programme d’installation peut modifier fileQueue, le cas échéant.

Valeur de retour du programme d’installation

Un co-programme d’installation peut retourner NO_ERROR, ERROR_DI_POSTPROCESSING_REQUIRED ou un code d’erreur Win32.

Si un programme d’installation de classe gère correctement cette demande et que SetupDiCallClassInstaller doit ensuite appeler le gestionnaire par défaut, le programme d’installation de classe retourne ERROR_DI_DO_DEFAULT.

Si le programme d’installation de classe gère correctement cette demande, notamment en appelant directement le gestionnaire par défaut, le programme d’installation de classe doit retourner NO_ERROR et SetupDiCallClassInstaller n’appellera plus le gestionnaire par défaut par la suite.

Note Le programme d’installation de classe peut appeler directement le gestionnaire par défaut, mais le programme d’installation de classe ne doit jamais tenter de remplacer les opérations du gestionnaire par défaut.

Pour plus d’informations sur l’appel du gestionnaire par défaut, consultez Appel de gestionnaires de code DIF par défaut.

Si le programme d’installation de classe rencontre une erreur, le programme d’installation doit retourner un code d’erreur Win32 approprié et SetupDiCallClassInstaller n’appellera pas par la suite le gestionnaire par défaut.

Gestionnaire de code DIF par défaut

SetupDiInstallDriverFiles

Opération du programme d’installation

En réponse à une demande de DIF_INSTALLDEVICEFILES, un programme d’installation spécifie toutes les opérations de fichier nécessaires. Par exemple, un programme d’installation peut spécifier un fichier supplémentaire à copier requis pour l’installation de l’appareil. Si l’indicateur DI_NOVCP est défini, un programme d’installation spécifie les opérations de fichier en les ajoutant au FileQueue dans les paramètres d’installation de l’appareil. Consultez le Microsoft Windows SDK pour plus d’informations sur l’utilisation des files d’attente de fichiers et pour obtenir des pages de référence sur les fonctions de mise en file d’attente de fichiers telles que SetupInstallFilesFromInfSection.

Si cette demande DIF est envoyée pendant l’installation de l’appareil et que le programme d’installation retourne un code d’erreur Microsoft Win32, Windows arrête l’installation.

Si un composant d’installation d’appareil fourni par le système envoie cette demande DIF pour récupérer une liste des fichiers associés à un appareil, le composant récupère la file d’attente de fichiers, mais ne valide pas la file d’attente.

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)

Voir aussi