SetupDiEnumDeviceInfo, fonction (setupapi.h)

Article
08/26/2023

La fonction SetupDiEnumDeviceInfo retourne une structure SP_DEVINFO_DATA qui spécifie un élément d’informations sur l’appareil dans un jeu d’informations d’appareil.

Syntaxe

WINSETUPAPI BOOL SetupDiEnumDeviceInfo(
  [in]  HDEVINFO         DeviceInfoSet,
  [in]  DWORD            MemberIndex,
  [out] PSP_DEVINFO_DATA DeviceInfoData
);

Paramètres

[in] DeviceInfoSet

Handle pour le jeu d’informations d’appareil pour lequel retourner une structure de SP_DEVINFO_DATA qui représente un élément d’informations sur l’appareil.

[in] MemberIndex

Index de base zéro de l’élément d’informations de l’appareil à récupérer.

[out] DeviceInfoData

Pointeur vers une structure de SP_DEVINFO_DATA pour recevoir des informations sur un élément d’informations d’appareil énuméré. L’appelant doit définir DeviceInfoData. cbSize en sizeof(SP_DEVINFO_DATA).

Valeur retournée

La fonction retourne TRUE si elle réussit. Sinon, elle retourne FALSE et l’erreur journalisée peut être récupérée avec un appel à GetLastError.

Remarques

Les appels répétés à cette fonction retournent un élément d’informations d’appareil pour un autre appareil. Cette fonction peut être appelée à plusieurs reprises pour obtenir des informations sur tous les appareils dans le jeu d’informations sur l’appareil.

Pour énumérer les éléments d’informations sur l’appareil, un programme d’installation doit initialement appeler SetupDiEnumDeviceInfo avec le paramètre MemberIndex défini sur 0. Le programme d’installation doit ensuite incrémenter MemberIndex et appeler SetupDiEnumDeviceInfo jusqu’à ce qu’il n’y ait plus de valeurs (la fonction échoue et un appel à GetLastError retourne ERROR_NO_MORE_ITEMS).

Appelez SetupDiEnumDeviceInterfaces pour obtenir une structure de contexte pour un élément d’interface d’appareil (par rapport à un élément d’informations sur l’appareil).

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
DLL	Setupapi.dll
Ensemble d’API	ext-ms-win-setupapi-classinstallers-l1-1-0 (introduit dans Windows 8)