DIF_INSTALLINTERFACES

Une demande de DIF_INSTALLINTERFACES permet à un programme d’installation de participer à l’inscription des interfaces d’appareil pour un appareil.

Date d’envoi

Après l’inscription des co-programmes d’installation d’appareil, mais avant la fin de l’installation de l’appareil.

Qui gère

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
None

Sortie du programme d’installation

Paramètres d’installation de l’appareil
Un programme d’installation peut modifier les paramètres d’installation de l’appareil, mais pas généralement pour cette demande DIF.

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

SetupDiInstallDeviceInterfaces

Opération du programme d’installation

En réponse à une demande de DIF_INSTALLINTERFACES, un programme d’installation peut inscrire une interface d’appareil par programmation au lieu d’inscrire l’interface via le fichier INF. En règle générale, les programmes d’installation fournis par le fournisseur ne gèrent pas cette demande DIF.

À 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 les interfaces de l’appareil.

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 un programme d’installation inscrit une interface d’appareil, un composant en mode noyau pour l’appareil (par exemple, un pilote) doit appeler IoSetDeviceInterfaceState pour activer l’interface.

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

Voir aussi

SetupDiInstallDeviceInterfaces

SP_DEVINFO_DATA

SP_DEVINSTALL_PARAMS