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.

Syntax

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 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 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 ejecuta correctamente. De lo contrario, devuelve FALSE y el error registrado se puede recuperar con una llamada a GetLastError.

Observaciones

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).

Hay disponible un ejemplo de uso de SetupDiEnumDeviceInfo en la página que documenta SetupDiGetClassDevsW.

Requisitos

Consulte también

SP_DEVINFO_DATA

SetupDiCreateDeviceInfo

SetupDiDeleteDeviceInfo

setupDiEnumDeviceInterfaces

SetupDiOpenDeviceInfo