SetupDiSetDriverInstallParamsA, fonction (setupapi.h)

Article
08/26/2023

La fonction SetupDiSetDriverInstallParams définit les paramètres d’installation du pilote pour un élément d’informations de pilote.

Syntaxe

WINSETUPAPI BOOL SetupDiSetDriverInstallParamsA(
  [in]           HDEVINFO              DeviceInfoSet,
  [in, optional] PSP_DEVINFO_DATA      DeviceInfoData,
  [in]           PSP_DRVINFO_DATA_A    DriverInfoData,
  [in]           PSP_DRVINSTALL_PARAMS DriverInstallParams
);

Paramètres

[in] DeviceInfoSet

Handle d’un jeu d’informations de périphérique qui contient un élément d’informations sur le pilote qui représente le pilote pour lequel définir les paramètres d’installation.

[in, optional] DeviceInfoData

Pointeur vers une structure de SP_DEVINFO_DATA qui spécifie un élément d’informations sur l’appareil dans DeviceInfoSet. Ce paramètre est facultatif et peut être défini sur NULL. Si ce paramètre est spécifié, SetupDiSetDriverInstallParams définit les paramètres d’installation du pilote pour l’appareil spécifié. Si ce paramètre a la valeur NULL, SetupDiSetDriverInstallParams définit les paramètres d’installation du pilote pour DeviceInfoSet.

[in] DriverInfoData

Pointeur vers une structure de SP_DRVINFO_DATA qui spécifie le pilote pour lequel les paramètres d’installation sont définis. Si DeviceInfoData est spécifié, ce pilote doit être membre d’une liste de pilotes associée à DeviceInfoData. Si DeviceInfoData a la valeur NULL, ce pilote doit être membre de la liste des pilotes de classe globale pour DeviceInfoSet.

[in] DriverInstallParams

Pointeur vers une structure SP_DRVINSTALL_PARAMS qui spécifie les nouveaux paramètres d’installation du pilote.

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 par un appel à GetLastError.

Remarques

Notes

L’en-tête setupapi.h définit SetupDiSetDriverInstallParams en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

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

Voir aussi

SetupDiGetDriverInstallParams

Partager via