Función SetupDiEnumDeviceInfo (setupapi.h)

  • Artículo

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)

Consulte también

SP_DEVINFO_DATA

SetupDiCreateDeviceInfo

SetupDiDeleteDeviceInfo

SetupDiEnumDeviceInterfaces

SetupDiOpenDeviceInfo