SetupDiInstallDeviceInterfaces, fonction (setupapi.h)

Article
03/01/2024

La fonction SetupDiInstallDeviceInterfaces est le gestionnaire par défaut de la demande d’installation DIF_INSTALLINTERFACES .

Syntaxe

WINSETUPAPI BOOL SetupDiInstallDeviceInterfaces(
  [in] HDEVINFO         DeviceInfoSet,
  [in] PSP_DEVINFO_DATA DeviceInfoData
);

Paramètres

[in] DeviceInfoSet

Pointeur vers le jeu d’informations sur l’appareil qui contient un élément d’informations sur l’appareil qui représente l’appareil pour lequel installer des interfaces. Le jeu d’informations sur l’appareil doit contenir uniquement des éléments pour le système local.

[in] DeviceInfoData

Pointeur vers une structure de SP_DEVINFO_DATA qui spécifie l’élément d’informations sur l’appareil dans DeviceInfoSet.

Valeur retournée

SetupDiInstallDeviceInterfaces retourne TRUE si la fonction s’est terminée sans erreur. Si la fonction s’est terminée avec une erreur, FALSE est retourné et le code d’erreur de l’échec peut être récupéré en appelant GetLastError.

Remarques

SetupDiInstallDeviceInterfaces traite chaque entrée AddInterface dans DDInstall. Section Interfaces d’un fichier INF d’appareil et crée chaque interface en appelant SetupDiCreateDeviceInterface.

L’appelant de SetupDiInstallDeviceInterfaces doit être membre du groupe Administrateurs.

Note Seul un programme d’installation de classe doit appeler SetupDiInstallDeviceInterfaces et uniquement dans les situations où le programme d’installation de classe doit effectuer des opérations d’installation de l’interface d’appareil après que SetupDiInstallDeviceInterfaces a terminé l’opération d’installation de l’interface d’appareil par défaut. Dans de telles situations, le programme d’installation de classe doit appeler directement SetupDiInstallDeviceInterfaces lorsque le programme d’installation traite une demande de DIF_INSTALLINTERFACES. Pour plus d’informations sur l’appel du gestionnaire par défaut, consultez Appel de gestionnaires de code DIF par défaut.

Pour plus d’informations sur le format de fichier INF, consultez Sections et directives de fichier INF.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	setupapi.h (inclure Setupapi.h)
Bibliothèque	Setupapi.lib
DLL	Setupapi.dll

Voir aussi

DIF_INSTALLINTERFACES

SetupDiCreateDeviceInterface

Partager via