Função SetupDiCreateDeviceInfoList (setupapi.h)

  • Artigo

A função SetupDiCreateDeviceInfoList cria um conjunto de informações de dispositivo vazio e, opcionalmente, associa o conjunto a uma classe de configuração de dispositivo e uma janela de nível superior.

Sintaxe

WINSETUPAPI HDEVINFO SetupDiCreateDeviceInfoList(
  [in, optional] const GUID *ClassGuid,
  [in, optional] HWND       hwndParent
);

Parâmetros

[in, optional] ClassGuid

Um ponteiro para o GUID da classe de configuração do dispositivo a ser associado ao conjunto de informações do dispositivo recém-criado. Se esse parâmetro for especificado, somente os dispositivos dessa classe poderão ser incluídos neste conjunto de informações do dispositivo. Se esse parâmetro for definido como NULL, o conjunto de informações do dispositivo não será associado a uma classe de configuração de dispositivo específica.

[in, optional] hwndParent

Um identificador para a janela de nível superior a ser usada para qualquer interface do usuário relacionada a ações não específicas do dispositivo (como uma caixa de diálogo select-device que usa a lista de drivers de classe global). Esse identificador é opcional e pode ser NULL. Se uma janela de nível superior específica não for necessária, defina hwndParent como NULL.

Valor retornado

A função retornará um identificador para um conjunto de informações de dispositivo vazio se for bem-sucedida. Caso contrário, ele retornará INVALID_HANDLE_VALUE. Para obter informações de erro estendidas, chame GetLastError.

Comentários

O chamador dessa função deve excluir o conjunto de informações do dispositivo retornado quando ele não for mais necessário chamando SetupDiDestroyDeviceInfoList.

Para criar uma lista de informações do dispositivo para um computador remoto, use SetupDiCreateDeviceInfoListEx.

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-1 (introduzido no Windows 8.1)

Confira também

SetupDiCreateDeviceInfoListEx

SetupDiDestroyDeviceInfoList

SetupDiGetClassDevs

SetupDiGetDeviceInfoListClass