Fonction SetupDiGetSelectedDevice (setupapi.h)
La fonction SetupDiGetSelectedDevice récupère l’élément d’informations sur l’appareil sélectionné dans un jeu d’informations d’appareil.
Syntaxe
WINSETUPAPI BOOL SetupDiGetSelectedDevice(
[in] HDEVINFO DeviceInfoSet,
[out] PSP_DEVINFO_DATA DeviceInfoData
);
Paramètres
[in] DeviceInfoSet
Handle du jeu d’informations sur l’appareil pour lequel récupérer l’élément d’informations sur l’appareil sélectionné.
[out] DeviceInfoData
Pointeur vers une structure de SP_DEVINFO_DATA qui reçoit des informations sur l’élément d’informations sur l’appareil sélectionné pour DeviceInfoSet. L’appelant doit définir DeviceInfoData.cbSize à sizeof(SP_DEVINFO_DATA). Si un appareil n’est actuellement pas sélectionné, la fonction échoue et un appel à GetLastError retourne ERROR_NO_DEVICE_SELECTED.
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
SetupDiGetSelectedDevice est généralement utilisé par un Assistant Installation.
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 |
| DLL | Setupapi.dll |