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)

Vedi anche

SetupDiEnumDeviceInfo

SetupDiGetClassDevs

SetupDiGetDeviceInterfaceDetail