SetupDiSetDriverInstallParamsA, fonction (setupapi.h)

Article
11/20/2024

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 vers un jeu d’informations d’appareil qui contient un élément d’informations de pilote qui représente le pilote pour lequel définir les paramètres d’installation.

[in, optional] DeviceInfoData

Pointeur vers une structure SP_DEVINFO_DATA qui spécifie un élément d’informations d’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 est NULL, SetupDiSetDriverInstallParams définit les paramètres d’installation du pilote pour DeviceInfoSet.

[in] DriverInfoData

Pointeur vers une structure 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 est 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 de retour

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

Remarques

Note

L’en-tête setupapi.h définit SetupDiSetDriverInstallParams comme 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. Le mélange 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows.
plateforme cible	Bureau
d’en-tête	setupapi.h (include Setupapi.h)
bibliothèque	Setupapi.lib

Voir aussi

SetupDiGetDriverInstallParams

Partager via