Função SetupDiSetDeviceInstallParamsW (setupapi.h)
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 de 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.
Valor de retorno
A função retornará TRUE se for bem-sucedida. Caso contrário, ele retorna FALSE e o erro registrado pode ser recuperado com uma chamada para GetLastError.
Observações
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.
Nota
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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Microsoft Windows 2000 e versões posteriores do Windows. |
| da Plataforma de Destino |
Área de trabalho |
| cabeçalho | setupapi.h (inclua Setupapi.h) |
| biblioteca | Setupapi.lib |