Função SetupDiSetDeviceInstallParamsW (setupapi.h)

  • Artigo

A função SetupDiSetDeviceInstallParams define 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 SetupDiSetDeviceInstallParamsW(
  [in]           HDEVINFO                DeviceInfoSet,
  [in, optional] PSP_DEVINFO_DATA        DeviceInfoData,
  [in]           PSP_DEVINSTALL_PARAMS_W DeviceInstallParams
);

Parâmetros

[in] DeviceInfoSet

Um identificador para o conjunto de informações do dispositivo para o qual definir parâmetros de instalação do dispositivo.

[in, optional] DeviceInfoData

Um ponteiro para uma estrutura SP_DEVINFO_DATA que especifica um elemento de informações do dispositivo em DeviceInfoSet. Esse parâmetro é opcional e pode ser definido como NULL. Se esse parâmetro for especificado, SetupDiSetDeviceInstallParams definirá os parâmetros de instalação para o dispositivo especificado. Se esse parâmetro for NULL, SetupDiSetDeviceInstallParams definirá os parâmetros de instalação associados à lista de driver de classe global para DeviceInfoSet.

[in] DeviceInstallParams

Um ponteiro para uma estrutura SP_DEVINSTALL_PARAMS que contém os novos valores dos parâmetros. O DeviceInstallParams.cbSize deve ser definido como o tamanho, em bytes, da estrutura antes que essa função seja chamada.

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

Todos os parâmetros são validados antes de qualquer alteração ser feita. Portanto, um valor retornado de FALSE indica que nenhum parâmetro foi modificado.

Observação

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

SetupDiGetDeviceInstallParams