Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 l’appareil.
Gérer les listes de pilotes.
Gérer les interfaces du périphérique.
Gérer les icônes et d’autres bitmaps.
Les tableaux suivants fournissent des résumés des types de fonctions suivants :
Fonctions d’installation du pilote
Fonctions d’information de l’appareil
Fonctions d’information du driver
Gestionnaires d’installation de périphériques
Fonctions de personnalisation de l’installation de l’appareil
Fonctions de classe de configuration
Fonctions de l’interface de périphérique
Fonctions de propriété d’appareil (Windows Vista et versions ultérieures)
Fonctions d’installation du pilote
Installe un package de pilotes spécifié 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) |
|
Désinstalle un appareil et supprime son nœud de périphérique (devnode) du système. (Windows 7 et versions ultérieures de Windows) |
|
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) |
|
Supprime un package de pilotes du magasin de pilotes. (Windows 10 version 1703 et versions ultérieures de Windows) |
|
Met à jour le package de pilotes installé pour les appareils PnP correspondants présents dans le système. |
|
Rétablit 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
Note
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.
Crée un jeu d’informations d’appareil vide. Ce jeu peut être associé à un GUID de classe. |
|
Crée un ensemble d’informations sur le périphérique vide. Ce jeu peut être associé à un GUID de classe et peut être destiné aux appareils sur un ordinateur distant. |
|
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é. |
|
Récupère des informations sur une instance d’appareil existante et l’ajoute au jeu d’informations d’appareil spécifié. |
|
Retourne une structure de contexte pour un élément d’informations sur le périphérique d’un jeu d’informations sur le périphérique. |
|
Récupère l’ID d’instance d’appareil associé à un élément d’informations sur l’appareil. |
|
Récupère le GUID de classe associé à un jeu d’informations d’appareil s’il a une classe associée. |
|
Récupère les informations associées à un jeu d’informations d’appareil, notamment le GUID de classe, le handle de l’ordinateur distant et le nom de l’ordinateur distant. |
|
Récupère les identificateurs des feuilles de propriétés d’un élément d’informations d’appareil spécifié ou de la classe de configuration de l’appareil d’un jeu d’informations d’appareil spécifié. |
|
Retourne un ensemble d’informations sur les périphériques qui contient tous les périphériques d’une classe spécifiée. |
|
Retourne un ensemble d’informations sur les périphériques qui contient tous les périphériques d’une classe spécifiée sur un ordinateur local ou distant. |
|
Définit l’élément d’informations de périphérique spécifié comme membre actuellement sélectionné d’un ensemble d’informations de périphérique. Cette fonction est généralement utilisée par un Assistant d’installation. |
|
Récupère le périphérique actuellement sélectionné pour le jeu d’informations de périphérique spécifié. |
|
Inscrit une instance d’appareil nouvellement créée auprès du gestionnaire de Plug-and-Play. |
|
Supprime un élément de l’ensemble d’informations sur le périphérique spécifié. Cette fonction ne supprime pas l’appareil physique. |
|
Détruit un jeu d’informations d’appareil et libère toute la mémoire associée. |
Fonctions d’informations sur le pilote logiciel
Génère une liste de pilotes associés à une instance d’appareil spécifiée ou à la liste des pilotes de classe globale du jeu d’informations sur l’appareil. |
|
Énumère les membres d’une liste d’informations de gestionnaire de pilote. |
|
Récupère des informations détaillées pour un élément d’informations de gestionnaire spécifié. |
|
Définit le membre spécifié d’une liste de drivers comme driver actuellement sélectionné. Il peut également être utilisé pour réinitialiser la liste des pilotes afin qu’il n’existe aucun pilote actuellement sélectionné. |
|
Récupère l’élément d’une liste de pilotes qui a été sélectionné comme pilote à installer. |
|
Annule une recherche de liste de pilotes en cours dans un autre thread. |
|
Détruit une liste d’informations sur le pilote. |
Gestionnaires d’installation de périphériques
Appelle le programme d’installation de classe approprié et tous les co-programmes d’installation enregistrés, avec la demande d’installation spécifiée. |
|
La routine de traitement par défaut de la requête DIF_PROPERTYCHANGE. Il peut être utilisé pour modifier l’état d’un appareil installé. |
|
Inscrit les programmes d’installation associés spécifiques au périphérique répertoriés dans le fichier INF pour le périphérique spécifié. Cette fonction est le gestionnaire par défaut pour DIF_REGISTER_COINSTALLERS. |
|
Gestionnaire par défaut de la requête DIF_INSTALLDEVICE. |
|
Gestionnaire par défaut de la requête DIF_INSTALLDEVICEFILES. |
|
Le gestionnaire par défaut pour la requête DIF_INSTALLINTERFACES. Il installe les interfaces répertoriées dans une section DDInstall.Interfaces d’un fichier INF de périphérique. |
|
Cette fonction est obsolète et ne peut pas être utilisée dans aucune version de Microsoft Windows. |
|
Gestionnaire par défaut de la requête DIF_REMOVEDEVICE. |
|
gestionnaire par défaut de la requête DIF_UNREMOVE. |
|
Gestionnaire par défaut de la requête DIF_REGISTERDEVICE. |
|
Gestionnaire par défaut de la requête DIF_SELECTDEVICE. |
|
Gestionnaire par défaut de la requête DIF_SELECTBESTCOMPATDRV. |
|
Gestionnaire par défaut pour la requête DIF_SELECTDEVICE. |
Fonctions de personnalisation de l’installation de l’appareil
Récupère les paramètres d’installation de classe pour un ensemble d’informations sur le périphérique ou un élément d’informations sur le périphérique particulier. |
|
Définit ou réinitialise les paramètres d’installation de classe pour un jeu d’informations d’appareil ou un élément d’informations d’appareil particulier. |
|
Récupère les paramètres d’installation de l’appareil pour un ensemble d’informations sur le périphérique ou un élément d’informations sur le périphérique particulier. |
|
Définit les paramètres d’installation du périphérique pour un ensemble d’informations sur le périphérique ou un élément d’informations sur le périphérique particulier. |
|
Récupère les paramètres d’installation pour le pilote spécifié. |
|
Définit les paramètres d’installation du pilote spécifié. |
Fonctions de configuration de classe
Retourne la liste des GUID de classe d’installation qui inclut chaque classe installée sur le système. |
|
Retourne la liste des GUID des classes d’installation qui inclut chaque classe installée sur le système local ou un système distant. |
|
Récupère la description de classe associée au GUID de classe d’installation spécifié. |
|
Récupère la description d’une classe de configuration installée sur un ordinateur local ou distant. |
|
Récupère la classe d’un fichier INF d’appareil spécifié. |
|
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. |
|
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. |
|
Récupère le nom de classe associé au GUID de classe. |
|
Récupère le nom de classe associé à un GUID de classe. La classe peut être installée sur un ordinateur local ou distant. |
|
Installe la section ClassInstall32 du fichier INF spécifié. |
|
Installe un programme d’installation de classe ou un programme d’installation de classe d’interface. |
|
Ouvre la clé de Registre de classe d’installation de périphérique ou une sous-clé spécifique de la classe. |
|
Ouvre la clé de Registre de classe d’installation de l’appareil, la clé de Registre de 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
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. |
|
Génère une liste d’images bitmap pour chaque classe installée sur un ordinateur local ou distant. |
|
Récupère l’index dans la liste d’images de classe d’une classe spécifiée. |
|
Récupère l’index de la mini-icône fournie pour la classe spécifiée. |
|
Dessine la mini-icône spécifiée à l’emplacement demandé. |
|
Charge à la fois la grande et la mini-icône pour la classe spécifiée. |
|
Charge une icône de périphérique pour un périphérique spécifié. (Windows Vista et versions ultérieures de Windows) |
|
Détruit une liste d’images de classes. |
Fonctions d’interface d’appareil
Note
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.
Enregistre la fonctionnalité du périphérique (une interface de périphérique) pour un périphérique. |
|
Récupère des informations sur une interface d’appareil existante et l’ajoute au jeu d’informations d’appareil spécifié. |
|
Retourne un alias de l’interface d’appareil spécifiée. |
|
Retourne un ensemble d’informations sur les périphériques qui contient tous les périphériques d’une classe spécifiée. |
|
Retourne un ensemble d’informations de périphériques qui contient tous les périphériques d’une classe spécifiée sur un ordinateur local ou distant. |
|
Retourne une structure de contexte pour un élément d’interface de périphérique d’un ensemble d’informations du périphérique. Chaque appel retourne des informations sur une interface de périphérique. La fonction peut être appelée à plusieurs reprises pour obtenir des informations sur plusieurs interfaces exposées par un ou plusieurs appareils. |
|
Retourne des détails sur une interface d’appareil particulière. |
|
Crée une sous-clé de Registre pour stocker des informations sur une instance d’interface d’appareil et retourne un descripteur vers la clé. |
|
Ouvre la sous-clé de Registre utilisée par les applications et les pilotes pour stocker des informations spécifiques à une instance d’interface d’appareil et retourne un handle à la clé. |
|
Supprime la sous-clé de Registre utilisée par les applications et les pilotes pour stocker des informations spécifiques à une instance d’interface d’appareil. |
|
Est le gestionnaire par défaut de la requête DIF_INSTALLINTERFACES. Il installe les interfaces répertoriées dans une section Interfaces de DDInstall d’un fichier INF de périphérique. |
|
Supprime du système une interface de périphérique enregistrée. |
|
Supprime une interface de périphérique d’un ensemble d’informations sur le périphérique. |
|
Définit une interface de périphérique spécifiée comme interface par défaut pour une classe de périphérique. |
|
Installe un programme d’installation de classe ou une classe d’installateur d’interface. |
|
Ouvre la clé de Registre de classe d’installation de périphérique, la clé de Registre de 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 de propriété d’appareil (Windows Vista et versions ultérieures)
Note
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.
Récupère une propriété d’appareil définie pour une classe d’installation d’appareil ou une classe d’interface d’appareil. |
|
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. |
|
Récupère un tableau des clés de propriété d’appareil qui représentent les propriétés de l’appareil définies pour une classe d’installation d’appareil ou une classe d’interface d’appareil. |
|
Récupère un tableau des clés de propriété d’appareil qui représentent les propriétés de l’appareil définies pour une classe d’installation d’appareil ou une classe d’interface d’appareil sur un ordinateur local ou distant. |
|
Récupère une propriété d’appareil définie pour une interface d’appareil. |
|
Récupère un tableau de clés de propriété d’appareil qui représentent les propriétés de l’appareil qui sont définies pour une interface d’appareil. |
|
Récupère une propriété d’instance de périphérique. |
|
Récupère un tableau des clés de propriété d’appareil qui représentent les propriétés de l’appareil définies pour une instance d’appareil. |
|
Définit une propriété de classe pour une classe d’installation d’appareil ou une classe d’interface d’appareil. |
|
Définit une propriété de périphérique pour une classe d’installation de périphérique ou une classe d’interface de périphérique sur un ordinateur local ou distant. |
|
Définit une propriété de périphérique pour une interface de périphérique. |
|
Définit une propriété d’instance d’appareil. |
Fonctions du Registre système
Note
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.
Crée une clé de stockage du Registre pour les informations de configuration spécifiques à l’appareil et retourne un descripteur vers la clé. |
|
Ouvre une clé de stockage de Registre pour les informations de configuration spécifiques à l’appareil et retourne une poignée vers la clé. |
|
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. |
|
Ouvre la clé de Registre de classe d’installation ou une sous-clé spécifique de la classe. |
|
Ouvre la clé de Registre de classe d’installation de l’appareil, la clé de Registre de 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. |
|
Crée une sous-clé de Registre nonvolatile pour stocker des informations sur une instance d’interface d’appareil et retourne un handle à la clé. |
|
Ouvre la sous-clé de Registre utilisée par les applications et les pilotes pour stocker des informations spécifiques à une instance d’interface d’appareil et retourne un descripteur à la clé. |
|
Supprime la sous-clé de Registre utilisée par les applications et les pilotes pour stocker des informations spécifiques à une instance d’interface d’appareil. |
|
Définit la propriété d’appareil Plug-and-Play spécifiée. |
|
Récupère la propriété d’appareil Plug-and-Play spécifiée. |
|
Récupère une propriété de classe d’appareil spécifiée à partir du Registre. |
|
Définit dans le Registre une propriété de classe d’appareil spécifiée. |
Autres fonctions
Récupère la section Modèles INF décorée appropriée à utiliser lors de l’installation d’un appareil à partir d’un fichier INF d’appareil. |
|
Récupère la section DDInstall appropriée à utiliser lors de l’installation d’un appareil à partir d’un fichier INF d’appareil. |
|
Récupère le nom de la section INF DDInstall qui installe un périphérique pour un système d’exploitation et une architecture de processeur spécifiés. |
|
Récupère le nom convivial associé à un ID de profil matériel. |
|
Récupère le nom convivial associé à un ID de profil matériel sur un ordinateur local ou distant. |
|
Récupère une liste de tous les ID de profil matériel actuellement définis. |
|
Récupère une liste de tous les ID de profil matériel actuellement définis sur un ordinateur local ou distant. |
|
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é. |