Função SetupDiGetDeviceInstallParamsA (setupapi.h)

  • Artigo

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

Sintaxe

WINSETUPAPI BOOL SetupDiGetDeviceInstallParamsA(
  [in]           HDEVINFO                DeviceInfoSet,
  [in, optional] PSP_DEVINFO_DATA        DeviceInfoData,
  [out]          PSP_DEVINSTALL_PARAMS_A DeviceInstallParams
);

Parâmetros

[in] DeviceInfoSet

Um identificador para o conjunto de informações do dispositivo que contém os parâmetros de instalação do dispositivo a serem recuperados.

[in, optional] 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, SetupDiGetDeviceInstallParams recuperará os parâmetros de instalação do dispositivo especificado. Se esse parâmetro for NULL, a função recuperará os parâmetros de instalação do dispositivo global associados a DeviceInfoSet.

[out] DeviceInstallParams

Um ponteiro para uma estrutura SP_DEVINSTALL_PARAMS que recebe os parâmetros de instalação do dispositivo. DeviceInstallParams. cbSize deve ser definido como o tamanho, em bytes, da estrutura antes de chamar essa função.

Retornar valor

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

Comentários

Observação

O cabeçalho setupapi.h define SetupDiGetDeviceInstallParams como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do 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

SP_DEVINFO_DATA

SP_DEVINSTALL_PARAMS

SetupDiSetDeviceInstallParams