Função SetupDiCreateDeviceInfoList (setupapi.h)
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) |