Funzione SetupDiEnumDeviceInterfaces (setupapi.h)
La funzione SetupDiEnumDeviceInterfaces enumera le interfacce del dispositivo contenute in un set di informazioni sul dispositivo.
Sintassi
WINSETUPAPI BOOL SetupDiEnumDeviceInterfaces(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData,
[in] const GUID *InterfaceClassGuid,
[in] DWORD MemberIndex,
[out] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData
);
Parametri
[in] DeviceInfoSet
Puntatore a un set di informazioni sul dispositivo che contiene le interfacce del dispositivo per cui restituire informazioni. Questo handle viene in genere restituito da SetupDiGetClassDevs.
[in, optional] DeviceInfoData
Puntatore a una struttura SP_DEVINFO_DATA che specifica un elemento informazioni sul dispositivo in DeviceInfoSet. Questo parametro è facoltativo e può essere NULL. Se questo parametro viene specificato, SetupDiEnumDeviceInterfaces vincola l'enumerazione alle interfacce supportate dal dispositivo specificato. Se questo parametro è NULL, le chiamate ripetute a SetupDiEnumDeviceInterfaces restituiscono informazioni sulle interfacce associate a tutti gli elementi di informazioni sul dispositivo in DeviceInfoSet. Questo puntatore viene in genere restituito da SetupDiEnumDeviceInfo.
[in] InterfaceClassGuid
Puntatore a un GUID che specifica la classe di interfaccia del dispositivo per l'interfaccia richiesta.
[in] MemberIndex
Indice in base zero nell'elenco di interfacce nel set di informazioni sul dispositivo. Il chiamante deve chiamare prima questa funzione con MemberIndex impostato su zero per ottenere la prima interfaccia. Incrementare quindi ripetutamente MemberIndex e recuperare un'interfaccia fino a quando questa funzione non riesce e GetLastError restituisce ERROR_NO_MORE_ITEMS.
Se DeviceInfoData specifica un particolare dispositivo, MemberIndex è relativo solo alle interfacce esposte da tale dispositivo.
[out] DeviceInterfaceData
Puntatore a un buffer allocato dal chiamante che contiene, in caso di esito positivo, una struttura SP_DEVICE_INTERFACE_DATA completata che identifica un'interfaccia che soddisfa i parametri di ricerca. Il chiamante deve impostare DeviceInterfaceData. cbSize a sizeof(SP_DEVICE_INTERFACE_DATA) prima di chiamare questa funzione.
Valore restituito
SetupDiEnumDeviceInterfaces restituisceTRUE se la funzione è stata completata senza errori. Se la funzione è stata completata con un errore, viene restituito FALSE e il codice di errore per l'errore può essere recuperato chiamando GetLastError.
Commenti
Le chiamate ripetute a questa funzione restituiscono una struttura SP_DEVICE_INTERFACE_DATA per un'interfaccia del dispositivo diversa. Questa funzione può essere chiamata ripetutamente per ottenere informazioni sulle interfacce in un set di informazioni sul dispositivo associato a un particolare elemento informazioni sul dispositivo o associate a tutti gli elementi di informazioni sul dispositivo.
DeviceInterfaceData punta a una struttura che identifica un'interfaccia del dispositivo richiesta. Per ottenere informazioni dettagliate su un'interfaccia, chiamare SetupDiGetDeviceInterfaceDetail. Le informazioni dettagliate includono il nome dell'interfaccia del dispositivo che può essere passata a una funzione Win32, ad esempio CreateFile (descritta in Microsoft Windows SDK documentazione) per ottenere un handle all'interfaccia.
Per altre informazioni, vedi Panoramica delle classi dell'interfaccia del dispositivo .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Microsoft Windows 2000 e versioni successive di Windows. |
| Piattaforma di destinazione | Desktop |
| Intestazione | setupapi.h (include Setupapi.h) |
| Libreria | Setupapi.lib |
| DLL | Setupapi.dll |
| Set di API | ext-ms-win-setupapi-classinstallers-l1-1-2 (introdotto in Windows 10, versione 10.0.14393) |