Função SetupDiGetSelectedDevice (setupapi.h)
A função SetupDiGetSelectedDevice recupera o elemento de informações do dispositivo selecionado em um conjunto de informações do dispositivo.
Sintaxe
WINSETUPAPI BOOL SetupDiGetSelectedDevice(
[in] HDEVINFO DeviceInfoSet,
[out] PSP_DEVINFO_DATA DeviceInfoData
);
Parâmetros
[in] DeviceInfoSet
Um identificador para o conjunto de informações do dispositivo para o qual recuperar o elemento de informações do dispositivo selecionado.
[out] DeviceInfoData
Um ponteiro para uma estrutura SP_DEVINFO_DATA que recebe informações sobre o elemento de informações do dispositivo selecionado para DeviceInfoSet. O chamador deve definir DeviceInfoData.cbSize to sizeof(SP_DEVINFO_DATA). Se um dispositivo não estiver selecionado no momento, a função falhará e uma chamada para GetLastError retornará ERROR_NO_DEVICE_SELECTED.
Retornar valor
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
SetupDiGetSelectedDevice geralmente é usado por um assistente de instalação.
Requisitos
| Requisito | Valor |
|---|---|
| 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 |