Función SetupDiEnumDeviceInfo (setupapi.h)
La función SetupDiEnumDeviceInfo devuelve una estructura SP_DEVINFO_DATA que especifica un elemento de información del dispositivo en un conjunto de información del dispositivo.
Sintaxis
WINSETUPAPI BOOL SetupDiEnumDeviceInfo(
[in] HDEVINFO DeviceInfoSet,
[in] DWORD MemberIndex,
[out] PSP_DEVINFO_DATA DeviceInfoData
);
Parámetros
[in] DeviceInfoSet
Identificador del conjunto de información del dispositivo para el que se va a devolver una estructura de SP_DEVINFO_DATA que representa un elemento de información del dispositivo.
[in] MemberIndex
Índice de base cero del elemento de información del dispositivo que se va a recuperar.
[out] DeviceInfoData
Puntero a una estructura de SP_DEVINFO_DATA para recibir información sobre un elemento de información de dispositivo enumerado. El autor de la llamada debe establecer DeviceInfoData. cbSize a sizeof(SP_DEVINFO_DATA).
Valor devuelto
La función devuelve TRUE si se realiza correctamente. De lo contrario, devuelve FALSE y el error registrado se puede recuperar con una llamada a GetLastError.
Comentarios
Las llamadas repetidas a esta función devuelven un elemento de información del dispositivo para un dispositivo diferente. Se puede llamar a esta función repetidamente para obtener información sobre todos los dispositivos del conjunto de información del dispositivo.
Para enumerar los elementos de información del dispositivo, un instalador debe llamar inicialmente a SetupDiEnumDeviceInfo con el parámetro MemberIndex establecido en 0. A continuación, el instalador debe incrementar MemberIndex y llamar a SetupDiEnumDeviceInfo hasta que no haya más valores (se produce un error en la función y se devuelve una llamada a GetLastErrorERROR_NO_MORE_ITEMS).
Llame a SetupDiEnumDeviceInterfaces para obtener una estructura de contexto para un elemento de interfaz de dispositivo (frente a un elemento de información del dispositivo).
Requisitos
| Cliente mínimo compatible | Disponible en Microsoft Windows 2000 y versiones posteriores de Windows. |
| Plataforma de destino | Escritorio |
| Encabezado | setupapi.h (incluya Setupapi.h) |
| Library | Setupapi.lib |
| Archivo DLL | Setupapi.dll |
| Conjunto de API | ext-ms-win-setupapi-classinstallers-l1-1-0 (introducido en Windows 8) |