Fonction SetupDiSetClassInstallParamsA (setupapi.h)

  • Article

La fonction SetupDiSetClassInstallParams définit ou efface les paramètres d’installation de classe pour un jeu d’informations d’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 de 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 a la valeur 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 contenus 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 l’élément ou le jeu d’informations d’appareil spécifié.

[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 en cours d’effacement), ClassInstallParamsSize doit être 0.

Valeur retournée

La fonction retourne TRUE si elle réussit. Sinon, il 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, une valeur de retour FALSE indique qu’aucun paramètre n’a été modifié.

Un effet secondaire de la définition des paramètres d’installation de classe est que l’indicateur 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é.

Notes

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

Configuration requise

   
Client minimal pris en charge Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows.
Plateforme cible Bureau
En-tête setupapi.h (inclure Setupapi.h)
Bibliothèque Setupapi.lib

Voir aussi

SetupDiGetClassInstallParams

SetupDiSetDeviceInstallParams