SetupDiGetDriverInstallParamsA, fonction (setupapi.h)

Article
11/20/2024

La fonction SetupDiGetDriverInstallParams récupère les paramètres d’installation du pilote pour un jeu d’informations sur l’appareil ou un élément d’informations d’appareil particulier.

Syntaxe

WINSETUPAPI BOOL SetupDiGetDriverInstallParamsA(
  [in]           HDEVINFO              DeviceInfoSet,
  [in, optional] PSP_DEVINFO_DATA      DeviceInfoData,
  [in]           PSP_DRVINFO_DATA_A    DriverInfoData,
  [out]          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 récupérer les paramètres d’installation.

[in, optional] DeviceInfoData

Pointeur vers une structure SP_DEVINFO_DATA qui contient un élément d’informations d’appareil qui représente l’appareil pour lequel récupérer les paramètres d’installation. Ce paramètre est facultatif et peut être NULL. Si ce paramètre est spécifié, SetupDiGetDriverInstallParams récupère des informations sur un pilote membre d’une liste de pilotes pour l’appareil spécifié. Si ce paramètre est NULL, SetupDiGetDriverInstallParams récupère des informations sur un pilote membre de la liste des pilotes de classe globale pour DeviceInfoSet.

[in] DriverInfoData

Pointeur vers une structure SP_DRVINFO_DATA qui spécifie l’élément d’informations du pilote qui représente le pilote pour lequel récupérer les paramètres d’installation. Si deviceInfoData est fourni, le pilote doit être membre de la liste des pilotes pour l’appareil spécifié par DeviceInfoData. Sinon, le pilote doit être membre de la liste des pilotes de classe globale pour DeviceInfoSet.

[out] DriverInstallParams

Pointeur vers une structure SP_DRVINSTALL_PARAMS pour recevoir les paramètres d’installation de ce 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 SetupDiGetDriverInstallParams 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

SetupDiSetDriverInstallParams

Partager via