SetupDiSetDeviceInstallParamsA, fonction (setupapi.h)
La fonction SetupDiSetDeviceInstallParams définit les paramètres d’installation de l’appareil pour un jeu d’informations d’appareil ou un élément d’informations d’appareil particulier.
Syntaxe
WINSETUPAPI BOOL SetupDiSetDeviceInstallParamsA(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData,
[in] PSP_DEVINSTALL_PARAMS_A DeviceInstallParams
);
Paramètres
[in] DeviceInfoSet
Handle vers l’ensemble d’informations d’appareil pour lequel définir les paramètres d’installation de l’appareil.
[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é, SetupDiSetDeviceInstallParams définit les paramètres d’installation de l’appareil spécifié. Si ce paramètre a la valeur NULL, SetupDiSetDeviceInstallParams définit les paramètres d’installation associés à la liste des pilotes de classe globale pour DeviceInfoSet.
[in] DeviceInstallParams
Pointeur vers une structure SP_DEVINSTALL_PARAMS qui contient les nouvelles valeurs des paramètres. DeviceInstallParams.cbSize doit être défini sur la taille, en octets, de la structure avant l’appel de cette fonction.
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
Tous les paramètres sont validés avant d’apporter des modifications. Par conséquent, la valeur de retour FALSE indique qu’aucun paramètre n’a été modifié.
Notes
L’en-tête setupapi.h définit SetupDiSetDeviceInstallParams 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. 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 |