Partager via


SetupDiGetDeviceInstallParamsA, fonction (setupapi.h)

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

Syntaxe

WINSETUPAPI BOOL SetupDiGetDeviceInstallParamsA(
  [in]           HDEVINFO                DeviceInfoSet,
  [in, optional] PSP_DEVINFO_DATA        DeviceInfoData,
  [out]          PSP_DEVINSTALL_PARAMS_A DeviceInstallParams
);

Paramètres

[in] DeviceInfoSet

Handle de l’ensemble d’informations sur l’appareil qui contient les paramètres d’installation de l’appareil à récupérer.

[in, optional] DeviceInfoData

Pointeur vers une structure SP_DEVINFO_DATA qui spécifie l’élément d’informations d’appareil dans DeviceInfoSet. Ce paramètre est facultatif et peut être NULL. Si ce paramètre est spécifié, SetupDiGetDeviceInstallParams récupère les paramètres d’installation de l’appareil spécifié. Si ce paramètre est NULL, la fonction récupère les paramètres d’installation d’appareil globaux associés à DeviceInfoSet.

[out] DeviceInstallParams

Pointeur vers une structure SP_DEVINSTALL_PARAMS qui reçoit les paramètres d’installation de l’appareil. DeviceInstallParams.cbSize doit être défini sur la taille, en octets, de la structure avant d’appeler cette fonction.

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

Remarques

Note

L’en-tête setupapi.h définit SetupDiGetDeviceInstallParams 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

SP_DEVINFO_DATA

SP_DEVINSTALL_PARAMS

SetupDiSetDeviceInstallParams