Compartilhar via


Função SetupDiSelectDevice (setupapi.h)

A função SetupDiSelectDevice é o manipulador padrão para a solicitação de DIF_SELECTDEVICE .

Sintaxe

WINSETUPAPI BOOL SetupDiSelectDevice(
  [in]      HDEVINFO         DeviceInfoSet,
  [in, out] PSP_DEVINFO_DATA DeviceInfoData
);

Parâmetros

[in] DeviceInfoSet

Um identificador para um conjunto de informações do dispositivo que contém um elemento de informações do dispositivo que representa o dispositivo para o qual selecionar um driver.

[in, out] DeviceInfoData

Um ponteiro para uma estrutura SP_DEVINFO_DATA que especifica o elemento de informações do dispositivo. Esse parâmetro é opcional e pode ser NULL. Se esse parâmetro for especificado, SetupDiSelectDevice selecionará o driver para o dispositivo especificado e definirá DeviceInfoData.ClassGuid para o GUID da classe de configuração do dispositivo para o driver selecionado. Se esse parâmetro for NULL, SetupDiSelectDevice definirá o driver selecionado na lista de driver de classe global para DeviceInfoSet.

Retornar valor

A função retornará TRUE se for bem-sucedida. Caso contrário, ele retornará FALSE e o erro registrado poderá ser recuperado por uma chamada para GetLastError.

Comentários

SetupDiSelectDevice manipula a interface do usuário que permite que o usuário selecione um driver para o dispositivo especificado ou um conjunto de informações do dispositivo se um dispositivo não for especificado. Ao definir o campo Sinalizadores da estrutura SP_DEVINSTALL_PARAMS para o dispositivo ou as informações do dispositivo definidas se um dispositivo não for especificado, o chamador poderá especificar o tratamento especial da interface do usuário, por exemplo, para permitir que os usuários selecionem um driver de um disco de instalação OEM.

Nota Somente um instalador de classe deve chamar SetupDiSelectDevice e somente nas situações em que o instalador de classe deve executar operações de seleção de driver após SetupDiSelectDevice concluir a operação de seleção de driver padrão. Nessas situações, o instalador de classe deve chamar diretamente SetupDiSelectDevice quando o instalador processa uma solicitação de DIF_SELECTDEVICE. Para obter mais informações sobre como chamar o manipulador padrão, consulte Chamando manipuladores de código DIF padrão.
 
SetupDiSelectDevice foi projetado principalmente para selecionar um driver para um dispositivo em um computador local antes de instalar o dispositivo. Embora SetupDiSelectDevice não falhe se o conjunto de informações do dispositivo for para um computador remoto, o resultado é de uso limitado porque o conjunto de informações do dispositivo não pode ser usado posteriormente com solicitações de instalação DIF_Xxx ou funções SetupDiXxx que não dão suporte a operações em um computador remoto. Em particular, o conjunto de informações do dispositivo não pode ser usado como entrada com uma solicitação de instalação DIF_INSTALLDEVICE para instalar um dispositivo em um computador remoto.

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

Confira também

SP_DEVINSTALL_PARAMS

SetupDiCallClassInstaller