Função SetupDiSetSelectedDriverA (setupapi.h)

  • Artigo

A função SetupDiSetSelectedDriver define ou redefine o driver selecionado para um elemento de informações do dispositivo ou o driver de classe selecionado para um conjunto de informações do dispositivo.

Sintaxe

WINSETUPAPI BOOL SetupDiSetSelectedDriverA(
  [in]      HDEVINFO           DeviceInfoSet,
  [in, out] PSP_DEVINFO_DATA   DeviceInfoData,
  [in, out] PSP_DRVINFO_DATA_A DriverInfoData
);

Parâmetros

[in] DeviceInfoSet

Um identificador para o conjunto de informações do dispositivo que contém a lista de drivers da qual selecionar um driver para um elemento de informações do dispositivo ou para o conjunto de informações do dispositivo.

[in, out] DeviceInfoData

Um ponteiro para uma estrutura SP_DEVINFO_DATA que especifica o elemento de informações do dispositivo em DeviceInfoSet. Esse parâmetro é opcional e pode ser NULL. Se esse parâmetro for especificado, SetupDiSetSelectedDriver definirá ou redefinirá o driver selecionado para o dispositivo especificado. Se esse parâmetro for NULL, SetupDiSetSelectedDriver definirá ou redefinirá o driver de classe selecionado para DeviceInfoSet.

[in, out] DriverInfoData

Um ponteiro para uma estrutura SP_DRVINFO_DATA que especifica o driver a ser selecionado. Esse parâmetro é opcional e pode ser NULL. Se esse parâmetro e DeviceInfoData forem fornecidos, o driver especificado deverá ser membro de uma lista de driver associada a DeviceInfoData. Se esse parâmetro for especificado e DeviceInfoData for NULL, o driver deverá ser um membro da lista de drivers de classe global para DeviceInfoSet. Se esse parâmetro for NULL, o driver selecionado será redefinido para o elemento de informações do dispositivo, se DeviceInfoData for especificado ou o conjunto de informações do dispositivo, se DeviceInfoData for NULL.

Se o DriverInfoData.Reservado é NULL, o chamador está solicitando uma pesquisa para um nó de driver com os parâmetros especificados (DriverType, Description e ProviderName). Se uma correspondência for encontrada, esse nó de driver será selecionado. O campo Reservado é atualizado na saída para refletir o nó de driver real em que a correspondência foi encontrada. Se uma correspondência não for encontrada, a função falhará e uma chamada para GetLastError retornará ERROR_INVALID_PARAMETER.

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

Se o chamador de SetupDiSetSelectedDriver for membro do grupo Administradores, a classe do dispositivo será definida como a classe do driver selecionado, desde que as duas classes sejam diferentes.

Se DriverInfoData for NULL, SetupDiSetSelectedDriver redefinirá o driver selecionado. Como resultado, não há nenhum driver selecionado.

Observação

O cabeçalho setupapi.h define SetupDiSetSelectedDriver como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de funçã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

Confira também

SetupDiGetSelectedDriver