DIF_REGISTER_COINSTALLERS

Article
06/15/2023

Une demande de DIF_REGISTER_COINSTALLERS permet à un programme d’installation de participer à l’inscription de co-programmes d’installation d’appareils.

Date d’envoi

Avant de terminer l’installation 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 sur l’appareil qui contient l’appareil pour lequel les co-programmes d’installation doivent être inscrits.

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
None

Sortie du programme d’installation

None

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

SetupDiRegisterCoDeviceInstallers

Opération du programme d’installation

En réponse à une demande de DIF_REGISTER_COINSTALLERS, un programme d’installation peut modifier la liste des co-programmes d’installation de l’appareil. Par exemple, un programme d’installation peut inscrire ou supprimer par programme un co-programme d’installation spécifique à l’appareil basé sur l’analyse de l’appareil.

À moins que l’indicateur DI_NOFILECOPY soit défini, un programme d’installation qui gère cette demande DIF doit copier les fichiers requis pour le ou les co-programmes d’installation.

Si l’indicateur DI_NOFILECOPY est clair, mais que l’indicateur DI_NOVCP est défini, le programme d’installation doit mettre en file d’attente toutes les opérations de fichier dans la file d’attente fournie, mais ne doit pas valider la file d’attente.

Si le programme d’installation retourne un code d’erreur Win32, Windows arrête l’installation.

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