Funzione SetupDiEnumDeviceInfo (setupapi.h)
La funzione SetupDiEnumDeviceInfo restituisce una struttura SP_DEVINFO_DATA che specifica un elemento informazioni del dispositivo in un set di informazioni sul dispositivo.
Sintassi
WINSETUPAPI BOOL SetupDiEnumDeviceInfo(
[in] HDEVINFO DeviceInfoSet,
[in] DWORD MemberIndex,
[out] PSP_DEVINFO_DATA DeviceInfoData
);
Parametri
[in] DeviceInfoSet
Handle per il set di informazioni sul dispositivo per cui restituire una struttura SP_DEVINFO_DATA che rappresenta un elemento informativo del dispositivo.
[in] MemberIndex
Indice in base zero dell'elemento informativo del dispositivo da recuperare.
[out] DeviceInfoData
Puntatore a una struttura SP_DEVINFO_DATA per ricevere informazioni su un elemento informazioni sul dispositivo enumerato. Il chiamante deve impostare DeviceInfoData. cbSize su sizeof(SP_DEVINFO_DATA).
Valore restituito
La funzione restituisce TRUE se ha esito positivo. In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato con una chiamata a GetLastError.
Commenti
Chiamate ripetute a questa funzione restituiscono un elemento informazioni dispositivo per un dispositivo diverso. Questa funzione può essere chiamata ripetutamente per ottenere informazioni su tutti i dispositivi nel set di informazioni sul dispositivo.
Per enumerare gli elementi delle informazioni sul dispositivo, un programma di installazione deve inizialmente chiamare SetupDiEnumDeviceInfo con il parametro MemberIndex impostato su 0. Il programma di installazione deve quindi incrementare MemberIndex e chiamare SetupDiEnumDeviceInfo fino a quando non sono presenti più valori (la funzione ha esito negativo e una chiamata a GetLastError restituisce ERROR_NO_MORE_ITEMS).
Chiamare SetupDiEnumDeviceInterfaces per ottenere una struttura di contesto per un elemento dell'interfaccia del dispositivo (rispetto a un elemento informazioni sul dispositivo).
Requisiti
| Client minimo supportato | Disponibile in Microsoft Windows 2000 e versioni successive di Windows. |
| Piattaforma di destinazione | Desktop |
| Intestazione | setupapi.h (includere Setupapi.h) |
| Libreria | Setupapi.lib |
| DLL | Setupapi.dll |
| Set di API | ext-ms-win-setupapi-classinstallers-l1-1-0 (introdotto in Windows 8) |