DIF_UNREMOVE

Article
06/15/2023

Une demande de DIF_UNREMOVE informe le programme d’installation que Windows est sur le point de rétablir un appareil dans un profil matériel donné et donne au programme d’installation la possibilité de participer à l’opération. Windows envoie cette demande uniquement pour les appareils non PnP.

Date d’envoi

Lorsqu’un appareil énuméré par la racine, non PnP est rétabli dans un profil matériel.

Qui gère

Co-programme d’installation de classe	Peut gérer
Co-programme d’installation d’appareil	Peut gérer
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 de SP_DEVINFO_DATA qui identifie l’appareil dans le jeu d’informations sur 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_UNREMOVEDEVICE_PARAMS est associée à DeviceInfoData. Le champ Étendue doit être défini sur DI_UNREMOVEDEVICE_CONFIGSPECIFIC et un profil matériel doit être spécifié dans le champ HwProfile .

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 requête 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 des 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

SetupDiUnremoveDevice

Opération du programme d’installation

« Annuler la suppression » d’un appareil signifie essentiellement que Windows efface un indicateur qui a précédemment marqué un appareil comme « non présent » dans un profil matériel particulier.

Pour plus d’informations sur les codes DIF, consultez Gestion des codes DIF.