SetupDiEnumDeviceInfo, fonction (setupapi.h)

La fonction SetupDiEnumDeviceInfo retourne une structure SP_DEVINFO_DATA qui spécifie un élément d’informations d’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 vers le jeu d’informations de l’appareil pour lequel retourner une structure 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 SP_DEVINFO_DATA pour recevoir des informations sur un élément d’informations d’appareil énuméré. L’appelant doit définir DeviceInfoData. cbSize à 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 du 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 qu’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’information sur l’appareil).

Un exemple d’utilisation de SetupDiEnumDeviceInfo est disponible sur la page documentant SetupDiGetClassDevsW.

Spécifications

Voir aussi

SP_DEVINFO_DATA

SetupDiCreateDeviceInfo

SetupDiDeleteDeviceInfo

SetupDiEnumDeviceInterfaces

SetupDiOpenDeviceInfo