Utilisation des fonctions d’installation d’appareil

Cette section récapitule les fonctions d’installation de l’appareil. En utilisant les fonctions d’installation de l’appareil, le logiciel d’installation peut effectuer les types d’opérations suivants :

• Installer les pilotes

• Gérer les codes DIF.

• Gérer les jeux d’informations sur les appareils.

• Gérer les listes de pilotes.

• Gérer les interfaces d’appareil.

• Gérer les icônes et autres bitmaps.

Les tableaux suivants fournissent des résumés des types de fonctions suivants :

Fonctions d’installation du pilote

Fonctions d’informations sur l’appareil

Fonctions d’informations sur les pilotes

Gestionnaires d’installation d’appareil

Fonctions de personnalisation de l’installation de l’appareil

Configurer les fonctions de classe

Fonctions Bitmap et Icône

Fonctions d’interface d’appareil

Fonctions de propriété d’appareil (Windows Vista et versions ultérieures)

Fonctions de Registre

Autres fonctions

Fonctions d’installation du pilote

DiInstallDevice	Installe un package de pilotes spécifié qui est préinstallé dans le magasin de pilotes sur un périphérique PnP présent dans le système. (Windows Vista et versions ultérieures de Windows)
DiUninstallDevice	Désinstalle un appareil et supprime son nœud d’appareil (devnode) du système. (Windows 7 et versions ultérieures de Windows)
DiInstallDriver	Préinstalle un package de pilotes dans le magasin de pilotes, puis installe le package de pilotes sur les périphériques PnP correspondants présents dans le système. (Windows Vista et versions ultérieures de Windows)
DiUninstallDriver	Supprime un package de pilotes du magasin de pilotes. (Windows 10 version 1703 et versions ultérieures de Windows)
UpdateDriverForPlugAndPlayDevices	Mises à jour le package de pilotes installé pour les appareils PnP correspondants présents dans le système.
DiRollbackDriver	Restaure le package de pilotes installé sur un périphérique spécifié dans le package de pilotes de sauvegarde défini pour l’appareil. (Windows Vista et versions ultérieures de Windows)

Fonctions d’informations sur l’appareil

Notes

SetupApi n’est pas pris en charge sur toutes les éditions de Windows. Dans la mesure du possible, vous devez utiliser des API de couche inférieure telles que celles disponibles via CfgMgr32.dll. Pour obtenir des conseils, consultez Portage de SetupApi vers CfgMgr32 .

SetupDiCreateDeviceInfoList	Crée un jeu d’informations d’appareil vide. Cet ensemble peut être associé à un GUID de classe.
SetupDiCreateDeviceInfoListEx	Crée un jeu d’informations d’appareil vide. Cet ensemble peut être associé à un GUID de classe et peut être destiné aux appareils sur un ordinateur distant.
SetupDiCreateDeviceInfo	Crée un élément d’informations sur l’appareil et l’ajoute en tant que nouveau membre au jeu d’informations d’appareil spécifié.
SetupDiOpenDeviceInfo	Récupère des informations sur un appareil existant instance et les ajoute au jeu d’informations d’appareil spécifié.
SetupDiEnumDeviceInfo	Retourne une structure de contexte pour un élément d’informations sur l’appareil d’un jeu d’informations sur l’appareil.
SetupDiGetDeviceInstanceId	Récupère l’ID de instance d’appareil associé à un élément d’informations d’appareil.
SetupDiGetDeviceInfoListClass	Récupère le GUID de classe associé à un jeu d’informations d’appareil s’il a une classe associée.
SetupDiGetDeviceInfoListDetail	Récupère les informations associées à un jeu d’informations d’appareil, notamment le GUID de classe, le handle d’ordinateur distant et le nom de l’ordinateur distant.
SetupDiGetClassDevPropertySheets	Récupère les handles dans les feuilles de propriétés d’un élément d’informations d’appareil spécifié ou de la classe d’installation d’appareil d’un jeu d’informations d’appareil spécifié.
SetupDiGetClassDevs	Retourne un jeu d’informations d’appareil qui contient tous les appareils d’une classe spécifiée.
SetupDiGetClassDevsEx	Retourne un jeu d’informations d’appareil qui contient tous les appareils d’une classe spécifiée sur un ordinateur local ou distant.
SetupDiSetSelectedDevice	Définit l’élément d’informations sur l’appareil spécifié comme étant le membre actuellement sélectionné d’un jeu d’informations sur l’appareil. Cette fonction est généralement utilisée par un Assistant Installation.
SetupDiGetSelectedDevice	Récupère l’appareil actuellement sélectionné pour le jeu d’informations d’appareil spécifié.
SetupDiRegisterDeviceInfo	Inscrit un appareil nouvellement créé instance auprès du gestionnaire de Plug-and-Play.
SetupDiDeleteDeviceInfo	Supprime un membre du jeu d’informations d’appareil spécifié. Cette fonction ne supprime pas l’appareil réel.
SetupDiDestroyDeviceInfoList	Détruit un ensemble d’informations d’appareil et libère toute la mémoire associée.

Fonctions d’informations sur les pilotes

SetupDiBuildDriverInfoList	Génère une liste de pilotes associés à un périphérique spécifié instance ou à la liste des pilotes de classe globale du jeu d’informations de périphérique.
SetupDiEnumDriverInfo	Énumère les membres d’une liste d’informations sur les pilotes.
SetupDiGetDriverInfoDetail	Récupère des informations détaillées pour un élément d’informations de pilote spécifié.
SetupDiSetSelectedDriver	Définit le membre spécifié d’une liste de pilotes en tant que pilote sélectionné. Il peut également être utilisé pour réinitialiser la liste des pilotes afin qu’il n’y ait aucun pilote actuellement sélectionné.
SetupDiGetSelectedDriver	Récupère le membre d’une liste de pilotes qui a été sélectionné comme pilote à installer.
SetupDiCancelDriverInfoSearch	Annule une recherche de liste de pilotes actuellement en cours dans un autre thread.
SetupDiDestroyDriverInfoList	Détruit une liste d’informations sur les pilotes.

Gestionnaires d’installation d’appareil

SetupDiCallClassInstaller	Appelle le programme d’installation de classe approprié et tous les co-programmes d’installation inscrits, avec la demande d’installation spécifiée.
SetupDiChangeState	Gestionnaire par défaut pour la demande de DIF_PROPERTYCHANGE. Il peut être utilisé pour modifier l’état d’un appareil installé.
SetupDiRegisterCoDeviceInstallers	Inscrit les co-programmes d’installation spécifiques à l’appareil répertoriés dans le fichier INF de l’appareil spécifié. Cette fonction est le gestionnaire par défaut pour DIF_REGISTER_COINSTALLERS.
SetupDiInstallDevice	Gestionnaire par défaut pour la demande de DIF_INSTALLDEVICE.
SetupDiInstallDriverFiles	Gestionnaire par défaut pour la demande de DIF_INSTALLDEVICEFILES.
SetupDiInstallDeviceInterfaces	Gestionnaire par défaut pour la demande de DIF_INSTALLINTERFACES. Il installe les interfaces répertoriées dans un DDInstall. Section Interfaces d’un fichier INF d’appareil.
SetupDiMoveDuplicateDevice	Cette fonction est obsolète et ne peut être utilisée dans aucune version de Microsoft Windows.
SetupDiRemoveDevice	Gestionnaire par défaut pour la demande de DIF_REMOVEDEVICE.
SetupDiUnremoveDevice	Gestionnaire par défaut pour la demande de DIF_UNREMOVE.
SetupDiRegisterDeviceInfo	Gestionnaire par défaut pour la demande de DIF_REGISTERDEVICE.
SetupDiSelectDevice	Gestionnaire par défaut pour la demande de DIF_SELECTDEVICE.
SetupDiSelectBestCompatDrv	Gestionnaire par défaut pour la demande de DIF_SELECTBESTCOMPATDRV.
SetupDiSelectDevice	Gestionnaire par défaut pour la demande de DIF_SELECTDEVICE.

Fonctions de personnalisation de l’installation de l’appareil

SetupDiGetClassInstallParams	Récupère les paramètres d’installation de classe pour un jeu d’informations d’appareil ou un élément d’informations d’appareil particulier.
SetupDiSetClassInstallParams	Définit ou efface les paramètres d’installation de classe pour un jeu d’informations d’appareil ou un élément d’informations d’appareil particulier.
SetupDiGetDeviceInstallParams	Récupère les paramètres d’installation de l’appareil pour un jeu d’informations d’appareil ou un élément d’informations d’appareil particulier.
SetupDiSetDeviceInstallParams	Définit les paramètres d’installation d’un appareil pour un jeu d’informations d’appareil ou un élément d’informations d’appareil particulier.
SetupDiGetDriverInstallParams	Récupère les paramètres d’installation du pilote spécifié.
SetupDiSetDriverInstallParams	Définit les paramètres d’installation du pilote spécifié.

Fonctions de classe d’installation

SetupDiBuildClassInfoList	Retourne une liste de GUID de classe d’installation qui inclut chaque classe installée sur le système.
SetupDiBuildClassInfoListEx	Retourne une liste de GUID de classe d’installation qui inclut chaque classe installée sur le système local ou un système distant.
SetupDiGetClassDescription	Récupère la description de la classe associée au GUID de classe d’installation spécifié.
SetupDiGetClassDescriptionEx	Récupère la description d’une classe d’installation installée sur un ordinateur local ou distant.
SetupDiGetINFClass	Récupère la classe d’un fichier INF d’appareil spécifié.
SetupDiClassGuidsFromName	Récupère les GUID associés au nom de classe spécifié. Cette liste est basée sur les classes actuellement installées sur le système.
SetupDiClassGuidsFromNameEx	Récupère les GUID associés au nom de classe spécifié. Cette liste résultante contient les classes actuellement installées sur un ordinateur local ou distant.
SetupDiClassNameFromGuid	Récupère le nom de classe associé au GUID de classe.
SetupDiClassNameFromGuidEx	Récupère le nom de classe associé à un GUID de classe. La classe peut être installée sur un ordinateur local ou distant.
SetupDiInstallClass	Installe la section ClassInstall32 du fichier INF spécifié.
SetupDiInstallClassEx	Installe un programme d’installation de classe ou une classe d’interface.
SetupDiOpenClassRegKey	Ouvre la clé de Registre de la classe d’installation de l’appareil ou une sous-clé spécifique de la classe.
SetupDiOpenClassRegKeyEx	Ouvre la clé de Registre de la classe d’installation de l’appareil, la clé de Registre de la classe d’interface d’appareil ou une sous-clé spécifique de la classe. Cette fonction ouvre la clé spécifiée sur l’ordinateur local ou sur un ordinateur distant.

Fonctions bitmap et icône

SetupDiGetClassImageList	Génère une liste d’images qui contient des bitmaps pour chaque classe installée et retourne la liste dans une structure de données.
SetupDiGetClassImageListEx	Génère une liste d’images bitmap pour chaque classe installée sur un ordinateur local ou distant.
SetupDiGetClassImageIndex	Récupère l’index dans la liste d’images de classe d’une classe spécifiée.
SetupDiGetClassBitmapIndex	Récupère l’index de la mini-icône fournie pour la classe spécifiée.
SetupDiDrawMiniIcon	Dessine la mini-icône spécifiée à l’emplacement demandé.
SetupDiLoadClassIcon	Charge à la fois la grande et la mini-icône pour la classe spécifiée.
SetupDiLoadDeviceIcon	Charge une icône d’appareil pour un appareil spécifié. (Windows Vista et versions ultérieures de Windows)
SetupDiDestroyClassImageList	Détruit une liste d’images de classe.

Fonctions d’interface d’appareil

Notes

SetupApi n’est pas pris en charge sur toutes les éditions de Windows. Dans la mesure du possible, vous devez utiliser des API de couche inférieure telles que celles disponibles via CfgMgr32.dll. Pour obtenir des conseils, consultez Portage de SetupApi vers CfgMgr32 .

SetupDiCreateDeviceInterface	Inscrit les fonctionnalités de l’appareil (une interface d’appareil) pour un appareil.
SetupDiOpenDeviceInterface	Récupère des informations sur une interface d’appareil existante et les ajoute au jeu d’informations d’appareil spécifié.
SetupDiGetDeviceInterfaceAlias	Retourne un alias de l’interface d’appareil spécifiée.
SetupDiGetClassDevs	Retourne un jeu d’informations d’appareil qui contient tous les appareils d’une classe spécifiée.
SetupDiGetClassDevsEx	Retourne un jeu d’informations d’appareil qui contient tous les appareils d’une classe spécifiée sur un ordinateur local ou distant.
SetupDiEnumDeviceInterfaces	Retourne une structure de contexte pour un élément d’interface d’appareil d’un jeu d’informations d’appareil. Chaque appel retourne des informations sur une interface d’appareil. La fonction peut être appelée à plusieurs reprises pour obtenir des informations sur plusieurs interfaces exposées par un ou plusieurs appareils.
SetupDiGetDeviceInterfaceDetail	Retourne des détails sur une interface d’appareil particulière.
SetupDiCreateDeviceInterfaceRegKey	Crée une sous-clé de Registre pour stocker des informations sur une interface d’appareil instance et retourne un handle à la clé.
SetupDiOpenDeviceInterfaceRegKey	Ouvre la sous-clé de Registre utilisée par les applications et les pilotes pour stocker des informations spécifiques à une interface d’appareil instance et retourne un handle à la clé.
SetupDiDeleteDeviceInterfaceRegKey	Supprime la sous-clé de Registre utilisée par les applications et les pilotes pour stocker des informations spécifiques à une interface de périphérique instance.
SetupDiInstallDeviceInterfaces	Gestionnaire par défaut de la demande de DIF_INSTALLINTERFACES. Il installe les interfaces répertoriées dans un DDInstall. Section Interfaces d’un fichier INF d’appareil.
SetupDiRemoveDeviceInterface	Supprime une interface d’appareil inscrite du système.
SetupDiDeleteDeviceInterfaceData	Supprime une interface d’appareil d’un jeu d’informations d’appareil.
SetupDiSetDeviceInterfaceDefault	Définit une interface d’appareil spécifiée comme interface par défaut pour une classe d’appareil.
SetupDiInstallClassEx	Installe un programme d’installation de classe ou une classe d’interface.
SetupDiOpenClassRegKeyEx	Ouvre la clé de Registre de la classe d’installation de l’appareil , la clé de Registre de la classe d’interface de périphérique ou une sous-clé spécifique de la classe . Cette fonction ouvre la clé spécifiée sur l’ordinateur local ou sur un ordinateur distant.

Fonctions de propriété d’appareil (Windows Vista et versions ultérieures)

Notes

SetupApi n’est pas pris en charge sur toutes les éditions de Windows. Dans la mesure du possible, vous devez utiliser des API de couche inférieure telles que celles disponibles via CfgMgr32.dll. Pour obtenir des conseils, consultez Portage de SetupApi vers CfgMgr32 .

SetupDiGetClassProperty	Récupère une propriété d’appareil définie pour une classe d’installation d’appareil ou une classe d’interface d’appareil.
SetupDiGetClassPropertyEx	Récupère une propriété de classe pour une classe d’installation d’appareil ou une classe d’interface d’appareil sur un ordinateur local ou distant.
SetupDiGetClassPropertyKeys	Récupère un tableau des clés de propriété d’appareil qui représentent les propriétés d’appareil définies pour une classe d’installation d’appareil ou une classe d’interface d’appareil.
SetupDiGetClassPropertyKeysEx	Récupère un tableau des clés de propriété d’appareil qui représentent les propriétés d’appareil définies pour une classe d’installation d’appareil ou une classe d’interface d’appareil sur un ordinateur local ou distant.
SetupDiGetDeviceInterfaceProperty	Récupère une propriété d’appareil définie pour une interface d’appareil.
SetupDiGetDeviceInterfacePropertyKeys	Récupère un tableau de clés de propriété d’appareil qui représentent les propriétés d’appareil définies pour une interface d’appareil.
SetupDiGetDeviceProperty	Récupère une propriété de instance d’appareil.
SetupDiGetDevicePropertyKeys	Récupère un tableau des clés de propriété d’appareil qui représentent les propriétés d’appareil définies pour un instance d’appareil.
SetupDiSetClassProperty	Définit une propriété de classe pour une classe d’installation d’appareil ou une classe d’interface d’appareil.
SetupDiSetClassPropertyEx	Définit une propriété d’appareil pour une classe d’installation d’appareil ou une classe d’interface d’appareil sur un ordinateur local ou distant.
SetupDiSetDeviceInterfaceProperty	Définit une propriété d’appareil d’une interface d’appareil.
SetupDiSetDeviceProperty	Définit une propriété de instance d’appareil.

Fonctions de Registre

Notes

SetupApi n’est pas pris en charge sur toutes les éditions de Windows. Dans la mesure du possible, vous devez utiliser des API de couche inférieure telles que celles disponibles via CfgMgr32.dll. Pour obtenir des conseils, consultez Portage de SetupApi vers CfgMgr32 .

SetupDiCreateDevRegKey	Crée une clé de stockage de Registre pour les informations de configuration spécifiques à l’appareil et retourne un handle à la clé.
SetupDiOpenDevRegKey	Ouvre une clé de stockage de Registre pour obtenir des informations de configuration spécifiques à l’appareil et retourne un handle à la clé.
SetupDiDeleteDevRegKey	Supprime la ou les clés de Registre accessibles par l’utilisateur spécifiées associées à un élément d’informations sur l’appareil.
SetupDiOpenClassRegKey	Ouvre la clé de Registre de la classe setup ou une sous-clé spécifique de la classe .
SetupDiOpenClassRegKeyEx	Ouvre la clé de Registre de la classe d’installation de l’appareil, la clé de Registre de la classe d’interface de périphérique ou une sous-clé spécifique de la classe . Cette fonction ouvre la clé spécifiée sur l’ordinateur local ou sur un ordinateur distant.
SetupDiCreateDeviceInterfaceRegKey	Crée une sous-clé de Registre non volatile pour stocker des informations sur une interface d’appareil instance et retourne un handle à la clé.
SetupDiOpenDeviceInterfaceRegKey	Ouvre la sous-clé de Registre utilisée par les applications et les pilotes pour stocker des informations spécifiques à une interface d’appareil instance et retourne un handle à la clé.
SetupDiDeleteDeviceInterfaceRegKey	Supprime la sous-clé de Registre utilisée par les applications et les pilotes pour stocker des informations spécifiques à une interface de périphérique instance.
SetupDiSetDeviceRegistryProperty	Définit la propriété d’appareil Plug-and-Play spécifiée.
SetupDiGetDeviceRegistryProperty	Récupère la propriété d’appareil Plug-and-Play spécifiée.
SetupDiGetClassRegistryProperty	Récupère une propriété de classe d’appareil spécifiée à partir du Registre.
SetupDiSetClassRegistryProperty	Définit une propriété de classe d’appareil spécifiée dans le Registre.

Autres fonctions

SetupDiGetActualModelsSection	Récupère la section modèles INF décorés appropriée à utiliser lors de l’installation d’un appareil à partir d’un fichier INF d’appareil.
SetupDiGetActualSectionToInstall	Récupère la section DDInstall appropriée à utiliser lors de l’installation d’un appareil à partir d’un fichier INF d’appareil.
SetupDiGetActualSectionToInstallEx	Récupère le nom de la section INF DDInstall qui installe un appareil pour un système d’exploitation et une architecture de processeur spécifiés.
SetupDiGetHwProfileFriendlyName	Récupère le nom convivial associé à un ID de profil matériel.
SetupDiGetHwProfileFriendlyNameEx	Récupère le nom convivial associé à un ID de profil matériel sur un ordinateur local ou distant.
SetupDiGetHwProfileList	Récupère une liste de tous les ID de profil matériel actuellement définis.
SetupDiGetHwProfileListEx	Récupère une liste de tous les ID de profil matériel actuellement définis sur un ordinateur local ou distant.
SetupDiRestartDevices	Redémarre un appareil spécifié ou, si nécessaire, démarre tous les appareils qui sont gérés par les mêmes pilotes de fonction et de filtre que l’appareil spécifié.