SetupDiGetSelectedDriverA, fonction (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 de l’ensemble d’informations de l’appareil pour laquelle récupérer un pilote sélectionné.
[in, optional] DeviceInfoData
Pointeur vers une structure SP_DEVINFO_DATA qui spécifie un élément d’informations d’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 est 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 SP_DRVINFO_DATA qui reçoit des informations sur le pilote sélectionné.
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. Si aucun pilote n’a été sélectionné pour l’instance de périphérique spécifiée, l’erreur journalisée est ERROR_NO_DRIVER_SELECTED.
Remarques
Note
L’en-tête setupapi.h définit SetupDiGetSelectedDriver 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 |