Función SetupDiEnumDeviceInterfaces (setupapi.h)
La función SetupDiEnumDeviceInterfaces enumera las interfaces de dispositivo contenidas en un conjunto de información del dispositivo.
Sintaxis
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
);
Parámetros
[in] DeviceInfoSet
Puntero a un conjunto de información de dispositivo que contiene las interfaces de dispositivo para las que se va a devolver información. Este identificador normalmente lo devuelve SetupDiGetClassDevs.
[in, optional] DeviceInfoData
Puntero a una estructura de SP_DEVINFO_DATA que especifica un elemento de información del dispositivo en DeviceInfoSet. Este parámetro es opcional y puede ser NULL. Si se especifica este parámetro, SetupDiEnumDeviceInterfaces restringe la enumeración a las interfaces admitidas por el dispositivo especificado. Si este parámetro es NULL, las llamadas repetidas a SetupDiEnumDeviceInterfaces devuelven información sobre las interfaces asociadas a todos los elementos de información del dispositivo en DeviceInfoSet. Este puntero normalmente lo devuelve SetupDiEnumDeviceInfo.
[in] InterfaceClassGuid
Puntero a un GUID que especifica la clase de interfaz de dispositivo para la interfaz solicitada.
[in] MemberIndex
Índice de base cero en la lista de interfaces del conjunto de información del dispositivo. El llamador debe llamar primero a esta función con MemberIndex establecido en cero para obtener la primera interfaz. A continuación, incremente repetidamente MemberIndex y recupere una interfaz hasta que se produzca un error en esta función y GetLastError devuelva ERROR_NO_MORE_ITEMS.
Si DeviceInfoData especifica un dispositivo determinado, MemberIndex es relativo solo a las interfaces expuestas por ese dispositivo.
[out] DeviceInterfaceData
Puntero a un búfer asignado por el autor de la llamada que contiene, al devolverse correctamente, una estructura de SP_DEVICE_INTERFACE_DATA completada que identifica una interfaz que cumple los parámetros de búsqueda. El llamador debe establecer DeviceInterfaceData. cbSize a sizeof(SP_DEVICE_INTERFACE_DATA) antes de llamar a esta función.
Valor devuelto
SetupDiEnumDeviceInterfaces devuelve TRUE si la función se completó sin error. Si la función se completó con un error, se devuelve FALSE y se puede recuperar el código de error mediante una llamada a GetLastError.
Comentarios
Las llamadas repetidas a esta función devuelven una estructura de SP_DEVICE_INTERFACE_DATA para una interfaz de dispositivo diferente. Se puede llamar a esta función repetidamente para obtener información sobre las interfaces de un conjunto de información de dispositivo asociado a un elemento de información de dispositivo determinado o que están asociados a todos los elementos de información del dispositivo.
DeviceInterfaceData apunta a una estructura que identifica una interfaz de dispositivo solicitada. Para obtener información detallada sobre una interfaz, llame a SetupDiGetDeviceInterfaceDetail. La información detallada incluye el nombre de la interfaz de dispositivo que se puede pasar a una función Win32, como CreateFile (descrita en Microsoft Windows SDK documentación) para obtener un identificador de la interfaz.
Consulta Información general sobre las clases de interfaz de dispositivo para obtener más información.
Requisitos
| Requisito | Value |
|---|---|
| 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-2 (introducido en Windows 10, versión 10.0.14393) |