Fonction SetupDiGetSelectedDriverA (setupapi.h)
La fonction SetupDiGetSelectedDriver récupère le pilote sélectionné pour un jeu d’informations d’appareil ou un élément d’informations d’appareil particulier.
Syntaxe
WINSETUPAPI BOOL SetupDiGetSelectedDriverA(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData,
[out] PSP_DRVINFO_DATA_A DriverInfoData
);
Paramètres
[in] DeviceInfoSet
Handle du jeu d’informations d’appareil pour lequel récupérer un pilote sélectionné.
[in, optional] DeviceInfoData
Pointeur vers une structure de SP_DEVINFO_DATA qui spécifie un élément d’informations sur l’appareil qui représente l’appareil dans DeviceInfoSet pour lequel récupérer le pilote sélectionné. Ce paramètre est facultatif et peut être NULL. Si ce paramètre est spécifié, SetupDiGetSelectedDriver récupère le pilote sélectionné pour l’appareil spécifié. Si ce paramètre a la valeur NULL, SetupDiGetSelectedDriver récupère le pilote de classe sélectionné dans la liste des pilotes de classe globale associée à DeviceInfoSet.
[out] DriverInfoData
Pointeur vers une structure de SP_DRVINFO_DATA qui reçoit des informations sur le pilote sélectionné.
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. Si aucun pilote n’a été sélectionné pour le instance d’appareil spécifié, l’erreur journalisée est ERROR_NO_DRIVER_SELECTED.
Remarques
Notes
L’en-tête setupapi.h définit SetupDiGetSelectedDriver 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
| 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 |