SetupDiSetClassInstallParamsA, fonction (setupapi.h)
Le SetupDiSetClassInstallParams des jeux de fonctions ou efface les paramètres d’installation de classe pour un jeu d’informations sur l’appareil ou un élément d’informations d’appareil particulier.
Syntaxe
WINSETUPAPI BOOL SetupDiSetClassInstallParamsA(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData,
[in, optional] PSP_CLASSINSTALL_HEADER ClassInstallParams,
[in] DWORD ClassInstallParamsSize
);
Paramètres
[in] DeviceInfoSet
Handle du jeu d’informations d’appareil pour lequel définir les paramètres d’installation de classe.
[in, optional] DeviceInfoData
Pointeur vers une structure SP_DEVINFO_DATA qui représente l’appareil pour lequel définir les paramètres d’installation de classe. Ce paramètre est facultatif et peut être NULL. Si ce paramètre est spécifié, SetupDiSetClassInstallParams définit les paramètres d’installation de classe pour l’appareil spécifié. Si ce paramètre est NULL, SetupDiSetClassInstallParams définit les paramètres d’installation de classe associés à DeviceInfoSet.
[in, optional] ClassInstallParams
Pointeur vers une mémoire tampon qui contient les nouveaux paramètres d’installation de classe à utiliser. La structure SP_CLASSINSTALL_HEADER au début de cette mémoire tampon doit avoir son champ cbSize défini sur sizeof(SP_CLASSINSTALL_HEADER) et le champ InstallFunction doit être défini sur le code DI_FUNCTION qui reflète le type de paramètres contenu dans le reste de la mémoire tampon.
Si ClassInstallParams n’est pas spécifié, les paramètres d’installation de classe actuels, le cas échéant, sont effacés pour le jeu ou l’élément d’informations d’appareil spécifiés.
[in] ClassInstallParamsSize
Taille, en octets, de la mémoire tampon ClassInstallParams. Si la mémoire tampon n’est pas fournie (autrement dit, les paramètres d’installation de classe sont effacés), ClassInstallParamsSize doit être 0.
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 avec un appel à GetLastError.
Remarques
Tous les paramètres sont validés avant toute modification. Par conséquent, une valeur de retour de FALSE indique qu’aucun paramètre n’a été modifié.
L’effet secondaire de la définition des paramètres d’installation de classe est que l’indicateur de DI_CLASSINSTALLPARAMS est défini. Si l’appelant souhaite définir les paramètres, mais désactiver leur utilisation, cet indicateur doit être effacé par un appel à SetupDiSetDeviceInstallParams.
Si les paramètres d’installation de classe sont effacés, l’indicateur DI_CLASSINSTALLPARAMS est réinitialisé.
Note
L’en-tête setupapi.h définit SetupDiSetClassInstallParams 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 |