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 d’interface d’appareil
Fonctions de propriété d’appareil (Windows Vista et versions ultérieures)
Fonctions d’installation du pilote
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) |
|
Désinstalle un appareil et supprime son nœud d’appareil (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) |
|
Mises à jour le package de pilotes installé pour les appareils PnP correspondants présents dans le système. |
|
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 .
Crée un jeu d’informations d’appareil vide. Cet ensemble peut être associé à un GUID de classe. |
|
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. |
|
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 un appareil existant instance et les ajoute au jeu d’informations d’appareil spécifié. |
|
Retourne une structure de contexte pour un élément d’informations sur l’appareil d’un jeu d’informations sur l’appareil. |
|
Récupère l’ID de instance d’appareil associé à un élément d’informations d’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 d’ordinateur distant et le nom de l’ordinateur distant. |
|
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é. |
|
Retourne un jeu d’informations d’appareil qui contient tous les appareils d’une classe spécifiée. |
|
Retourne un jeu d’informations d’appareil qui contient tous les appareils d’une classe spécifiée sur un ordinateur local ou distant. |
|
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. |
|
Récupère l’appareil actuellement sélectionné pour le jeu d’informations d’appareil spécifié. |
|
Inscrit un appareil nouvellement créé instance auprès du gestionnaire de Plug-and-Play. |
|
Supprime un membre du jeu d’informations d’appareil spécifié. Cette fonction ne supprime pas l’appareil réel. |
|
Détruit un ensemble d’informations d’appareil et libère toute la mémoire associée. |
Fonctions d’informations sur les pilotes
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. |
|
Énumère les membres d’une liste d’informations sur les pilotes. |
|
Récupère des informations détaillées pour un élément d’informations de pilote spécifié. |
|
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é. |
|
Récupère le membre d’une liste de pilotes qui a été sélectionné comme pilote à installer. |
|
Annule une recherche de liste de pilotes actuellement en cours dans un autre thread. |
|
Détruit une liste d’informations sur les pilotes. |
Gestionnaires d’installation d’appareil
Appelle le programme d’installation de classe approprié et tous les co-programmes d’installation inscrits, avec la demande d’installation spécifiée. |
|
Gestionnaire par défaut pour la demande de DIF_PROPERTYCHANGE. Il peut être utilisé pour modifier l’état d’un appareil installé. |
|
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. |
|
Gestionnaire par défaut pour la demande de DIF_INSTALLDEVICE. |
|
Gestionnaire par défaut pour la demande de DIF_INSTALLDEVICEFILES. |
|
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. |
|
Cette fonction est obsolète et ne peut être utilisée dans aucune version de Microsoft Windows. |
|
Gestionnaire par défaut pour la demande de DIF_REMOVEDEVICE. |
|
Gestionnaire par défaut pour la demande de DIF_UNREMOVE. |
|
Gestionnaire par défaut pour la demande de DIF_REGISTERDEVICE. |
|
Gestionnaire par défaut pour la demande de DIF_SELECTDEVICE. |
|
Gestionnaire par défaut pour la demande de DIF_SELECTBESTCOMPATDRV. |
|
Gestionnaire par défaut pour la demande de DIF_SELECTDEVICE. |
Fonctions de personnalisation de l’installation de l’appareil
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. |
|
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. |
|
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. |
|
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. |
|
Récupère les paramètres d’installation du pilote spécifié. |
|
Définit les paramètres d’installation du pilote spécifié. |
Fonctions de classe d’installation
Retourne une liste de GUID de classe d’installation qui inclut chaque classe installée sur le système. |
|
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. |
|
Récupère la description de la classe associée au GUID de classe d’installation spécifié. |
|
Récupère la description d’une classe d’installation 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 une classe d’interface. |
|
Ouvre la clé de Registre de la classe d’installation de l’appareil ou une sous-clé spécifique de la classe. |
|
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
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 d’appareil pour un appareil spécifié. (Windows Vista et versions ultérieures de Windows) |
|
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 .
Inscrit les fonctionnalités de l’appareil (une interface d’appareil) pour un appareil. |
|
Récupère des informations sur une interface d’appareil existante et les ajoute au jeu d’informations d’appareil spécifié. |
|
Retourne un alias de l’interface d’appareil spécifiée. |
|
Retourne un jeu d’informations d’appareil qui contient tous les appareils d’une classe spécifiée. |
|
Retourne un jeu d’informations d’appareil qui contient tous les appareils d’une classe spécifiée sur un ordinateur local ou distant. |
|
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. |
|
Retourne des détails sur une interface d’appareil particulière. |
|
Crée une sous-clé de Registre pour stocker des informations sur une interface d’appareil instance 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 interface d’appareil instance 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 interface de périphérique instance. |
|
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. |
|
Supprime une interface d’appareil inscrite du système. |
|
Supprime une interface d’appareil d’un jeu d’informations d’appareil. |
|
Définit une interface d’appareil spécifiée comme interface par défaut pour une classe d’appareil. |
|
Installe un programme d’installation de classe ou une classe d’interface. |
|
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 .
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 d’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 d’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 d’appareil définies pour une interface d’appareil. |
|
Récupère une propriété de instance d’appareil. |
|
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. |
|
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é d’appareil pour une classe d’installation d’appareil ou une classe d’interface d’appareil sur un ordinateur local ou distant. |
|
Définit une propriété d’appareil d’une interface d’appareil. |
|
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 .
Crée une clé de stockage de Registre pour les informations de configuration spécifiques à l’appareil et retourne un handle à la clé. |
|
Ouvre une clé de stockage de Registre pour obtenir des informations de configuration spécifiques à l’appareil et retourne un handle à 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 la classe setup ou une sous-clé spécifique de la classe . |
|
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. |
|
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é. |
|
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é. |
|
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. |
|
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 une propriété de classe d’appareil spécifiée dans le Registre. |
Autres fonctions
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. |
|
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 appareil 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é. |
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour