SetupDiGetClassInstallParamsA, fonction (setupapi.h)

Article
11/20/2024

La fonction SetupDiGetClassInstallParams récupère 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 SetupDiGetClassInstallParamsA(
  [in]            HDEVINFO                DeviceInfoSet,
  [in, optional]  PSP_DEVINFO_DATA        DeviceInfoData,
  [out, optional] PSP_CLASSINSTALL_HEADER ClassInstallParams,
  [in]            DWORD                   ClassInstallParamsSize,
  [out, optional] PDWORD                  RequiredSize
);

Paramètres

[in] DeviceInfoSet

Handle vers un jeu d’informations d’appareil qui contient les paramètres d’installation de classe à récupérer.

[in, optional] DeviceInfoData

Pointeur vers une structure SP_DEVINFO_DATA qui a spécifié un élément d’informations d’appareil dans DeviceInfoSet. Ce paramètre est facultatif et peut être NULL. Si ce paramètre est spécifié, SetupDiGetClassInstallParams récupère les paramètres d’installation de classe pour l’appareil spécifié. Si ce paramètre est NULL, SetupDiGetClassInstallParams récupère les paramètres d’installation de classe pour la liste des pilotes de classe globale associée à DeviceInfoSet.

[out, optional] ClassInstallParams

Pointeur vers une mémoire tampon qui contient une structure SP_CLASSINSTALL_HEADER. Cette structure doit avoir son cbSize membre défini sur sizeof(SP_CLASSINSTALL_HEADER) sur l’entrée ou la mémoire tampon est considérée comme non valide. En sortie, le membre InstallFunction est rempli avec le code de fonction d’installation de l’appareil pour les paramètres d’installation de classe récupérés. Si la mémoire tampon est suffisamment grande, elle reçoit également la structure des paramètres d’installation de classe spécifique au code de fonction. Si ClassInstallParams n’est pas spécifié, ClassInstallParamsSize doit être 0.

[in] ClassInstallParamsSize

Taille, en octets, de la mémoire tampon ClassInstallParams. Si la mémoire tampon est fournie, elle doit être au moins aussi grande que sizeof(SP_CLASSINSTALL_HEADER). Si la mémoire tampon n’est pas fournie, ClassInstallParamsSize doit être 0.

[out, optional] RequiredSize

Pointeur vers une variable de type DWORD qui reçoit le nombre d’octets requis pour stocker les paramètres d’installation de classe. Ce paramètre est facultatif et peut être NULL.

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

Les paramètres d’installation de classe sont spécifiques à un code de fonction d’installation d’appareil particulier stocké dans le champ ClassInstallHeader situé au début de la mémoire tampon ClassInstallParams.

Note

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

SetupDiSetClassInstallParams

Partager via