Função SetupDiGetDriverInstallParamsA (setupapi.h)

  • Artigo

A função SetupDiGetDriverInstallParams recupera parâmetros de instalação do driver para um conjunto de informações do dispositivo ou um elemento de informações de dispositivo específico.

Sintaxe

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

Parâmetros

[in] DeviceInfoSet

Um identificador para um conjunto de informações do dispositivo que contém um elemento de informações de driver que representa o driver para o qual recuperar parâmetros de instalação.

[in, optional] DeviceInfoData

Um ponteiro para uma estrutura SP_DEVINFO_DATA que contém um elemento de informações do dispositivo que representa o dispositivo para o qual recuperar parâmetros de instalação. Esse parâmetro é opcional e pode ser NULL. Se esse parâmetro for especificado, SetupDiGetDriverInstallParams recuperará informações sobre um driver que é membro de uma lista de driver para o dispositivo especificado. Se esse parâmetro for NULL, SetupDiGetDriverInstallParams recuperará informações sobre um driver que é membro da lista de drivers de classe global para DeviceInfoSet.

[in] DriverInfoData

Um ponteiro para uma estrutura SP_DRVINFO_DATA que especifica o elemento de informações do driver que representa o driver para o qual recuperar parâmetros de instalação. Se DeviceInfoData for fornecido, o driver deverá ser um membro da lista de driver para o dispositivo especificado por DeviceInfoData. Caso contrário, o driver deve ser um membro da lista de drivers de classe global para DeviceInfoSet.

[out] DriverInstallParams

Um ponteiro para uma estrutura SP_DRVINSTALL_PARAMS para receber os parâmetros de instalação desse driver.

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

Observação

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

SetupDiSetDriverInstallParams