Funzione SetupDiEnumDeviceInfo (setupapi.h)

  • Articolo

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)

Vedi anche

SP_DEVINFO_DATA

SetupDiCreateDeviceInfo

SetupDiDeleteDeviceInfo

SetupDiEnumDeviceInterfaces

SetupDiOpenDeviceInfo