Função SetupDiSetDriverInstallParamsW (setupapi.h)

Artigo
11/20/2024

A função SetupDiSetDriverInstallParams define parâmetros de instalação do driver para um elemento de informações do driver.

Sintaxe

WINSETUPAPI BOOL SetupDiSetDriverInstallParamsW(
  [in]           HDEVINFO              DeviceInfoSet,
  [in, optional] PSP_DEVINFO_DATA      DeviceInfoData,
  [in]           PSP_DRVINFO_DATA_W    DriverInfoData,
  [in]           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 definir parâmetros de instalação.

[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, SetupDiSetDriverInstallParams definirá os parâmetros de instalação do driver para o dispositivo especificado. Se esse parâmetro for NULL, SetupDiSetDriverInstallParams definirá parâmetros de instalação do driver para DeviceInfoSet.

[in] DriverInfoData

Um ponteiro para uma estrutura de SP_DRVINFO_DATA que especifica o driver para o qual os parâmetros de instalação são definidos. Se deviceInfoData for especificado, esse driver deverá ser membro de uma lista de driver associada a DeviceInfoData. Se deviceInfoData for NULL, esse driver deverá ser um membro da lista de driver de classe global para DeviceInfoSet.

[in] DriverInstallParams

Um ponteiro para uma estrutura de SP_DRVINSTALL_PARAMS que especifica os novos parâmetros de instalação do driver.

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 por uma chamada para GetLastError.

Observações

Nota

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

Consulte também

SetupDiGetDriverInstallParams

Compartilhar via