Função SetupDiEnumDeviceInfo (setupapi.h)

  • Artigo

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)

Confira também

SP_DEVINFO_DATA

SetupDiCreateDeviceInfo

SetupDiDeleteDeviceInfo

SetupDiEnumDeviceInterfaces

SetupDiOpenDeviceInfo