Função SetupDiGetSelectedDriverA (setupapi.h)

  • Artigo

A função SetupDiGetSelectedDriver recupera o driver selecionado para um conjunto de informações do dispositivo ou um elemento de informações de dispositivo específico.

Sintaxe

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

Parâmetros

[in] DeviceInfoSet

Um identificador para o conjunto de informações do dispositivo para o qual recuperar um driver selecionado.

[in, optional] DeviceInfoData

Um ponteiro para uma estrutura SP_DEVINFO_DATA que especifica um elemento de informações do dispositivo que representa o dispositivo em DeviceInfoSet para o qual recuperar o driver selecionado. Esse parâmetro é opcional e pode ser NULL. Se esse parâmetro for especificado, SetupDiGetSelectedDriver recuperará o driver selecionado para o dispositivo especificado. Se esse parâmetro for NULL, SetupDiGetSelectedDriver recuperará o driver de classe selecionado na lista de driver de classe global associada a DeviceInfoSet.

[out] DriverInfoData

Um ponteiro para uma estrutura SP_DRVINFO_DATA que recebe informações sobre o driver selecionado.

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. Se um driver não tiver sido selecionado para a instância do dispositivo especificada, o erro registrado será ERROR_NO_DRIVER_SELECTED.

Comentários

Observação

O cabeçalho setupapi.h define SetupDiGetSelectedDriver 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

SetupDiSetSelectedDriver