SetupDiInstallDriverFiles, fonction (setupapi.h)

Article
03/01/2024

La fonction SetupDiInstallDriverFiles est le gestionnaire par défaut pour la demande d’installation DIF_INSTALLDEVICEFILES .

Syntaxe

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

Paramètres

[in] DeviceInfoSet

Handle du jeu d’informations sur l’appareil qui contient l’élément d’informations sur l’appareil qui représente l’appareil pour lequel installer des fichiers. Le jeu d’informations sur l’appareil ne doit pas contenir d’éléments distants.

[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

La fonction retourne TRUE si elle réussit. Sinon, elle retourne FALSE et l’erreur journalisée peut être récupérée avec un appel à GetLastError.

Remarques

L’appelant de SetupDiInstallDriverFiles doit être membre du groupe Administrateurs si cette fonction est utilisée pour installer des fichiers. Toutefois, si cette fonction est utilisée pour créer une file d’attente de fichiers, l’appartenance au groupe Administrateurs n’est pas requise.

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

L’opération de SetupDiInstallDriverFiles est similaire à la fonction SetupDiInstallDevice . Toutefois, cette fonction effectue uniquement les opérations de copie de fichiers effectuées par SetupDiInstallDevice.

Un pilote doit être sélectionné pour l’ensemble ou l’élément d’informations de périphérique spécifié avant d’appeler cette fonction.

Cette fonction traite les entrées CopyFiles, Delfiles et Renfiles dans le fichier INF sélectionné.

DeviceInfoSet doit contenir uniquement des éléments sur l’ordinateur local.

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

SetupDiCallClassInstaller

SetupDiInstallDevice

Partager via