Função SetupDiEnumDeviceInfo (setupapi.h)
A função SetupDiEnumDeviceInfo retorna uma estrutura SP_DEVINFO_DATA que especifica um elemento de informações do dispositivo em um conjunto de informações do dispositivo.
Sintaxe
WINSETUPAPI BOOL SetupDiEnumDeviceInfo(
[in] HDEVINFO DeviceInfoSet,
[in] DWORD MemberIndex,
[out] PSP_DEVINFO_DATA DeviceInfoData
);
Parâmetros
[in] DeviceInfoSet
Um identificador para o conjunto de informações do dispositivo para o qual retornar uma estrutura SP_DEVINFO_DATA que representa um elemento de informações do dispositivo.
[in] MemberIndex
Um índice baseado em zero do elemento de informações do dispositivo a ser recuperado.
[out] DeviceInfoData
Um ponteiro para uma estrutura SP_DEVINFO_DATA para receber informações sobre um elemento de informações do dispositivo enumerado. O chamador deve definir DeviceInfoData. cbSize para sizeof(SP_DEVINFO_DATA).
Valor retornado
A função retornará TRUE se for bem-sucedida. Caso contrário, ele retornará FALSE e o erro registrado poderá ser recuperado com uma chamada para GetLastError.
Comentários
Chamadas repetidas para essa função retornam um elemento de informações do dispositivo para um dispositivo diferente. Essa função pode ser chamada repetidamente para obter informações sobre todos os dispositivos no conjunto de informações do dispositivo.
Para enumerar elementos de informações do dispositivo, um instalador deve chamar inicialmente SetupDiEnumDeviceInfo com o parâmetro MemberIndex definido como 0. Em seguida, o instalador deve incrementar MemberIndex e chamar SetupDiEnumDeviceInfo até que não haja mais valores (a função falha e uma chamada para GetLastError retorna ERROR_NO_MORE_ITEMS).
Chame SetupDiEnumDeviceInterfaces para obter uma estrutura de contexto para um elemento de interface do dispositivo (versus um elemento de informações do dispositivo).
Requisitos
| Cliente mínimo com suporte | Disponível no Microsoft Windows 2000 e versões posteriores do Windows. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | setupapi.h (inclua Setupapi.h) |
| Biblioteca | Setupapi.lib |
| DLL | Setupapi.dll |
| Conjunto de APIs | ext-ms-win-setupapi-classinstallers-l1-1-0 (introduzido no Windows 8) |