Função SetupDiSetClassInstallParamsW (setupapi.h)

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

Sintaxe

WINSETUPAPI BOOL SetupDiSetClassInstallParamsW(
  [in]           HDEVINFO                DeviceInfoSet,
  [in, optional] PSP_DEVINFO_DATA        DeviceInfoData,
  [in, optional] PSP_CLASSINSTALL_HEADER ClassInstallParams,
  [in]           DWORD                   ClassInstallParamsSize
);

Parâmetros

[in] DeviceInfoSet

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

[in, optional] DeviceInfoData

Um ponteiro para uma estrutura SP_DEVINFO_DATA que representa o dispositivo para o qual definir parâmetros de instalação de classe. Esse parâmetro é opcional e pode ser NULL. Se esse parâmetro for especificado, SetupDiSetClassInstallParams definirá os parâmetros de instalação de classe para o dispositivo especificado. Se esse parâmetro for NULL, SetupDiSetClassInstallParams definirá os parâmetros de instalação de classe associados a DeviceInfoSet.

[in, optional] ClassInstallParams

Um ponteiro para um buffer que contém os novos parâmetros de instalação de classe a serem usados. A estrutura SP_CLASSINSTALL_HEADER no início desse buffer deve ter seu campo cbSize definido como sizeof(SP_CLASSINSTALL_HEADER) e o campo InstallFunction deve ser definido como o código DI_FUNCTION que reflete o tipo de parâmetros contidos no restante do buffer.

Se ClassInstallParams não for especificado, os parâmetros de instalação da classe atual, se houver, serão limpos para o conjunto de informações do dispositivo ou elemento especificado.

[in] ClassInstallParamsSize

O tamanho, em bytes, do buffer ClassInstallParams . Se o buffer não for fornecido (ou seja, os parâmetros de instalação da classe estão sendo limpos), ClassInstallParamsSize deverá ser 0.

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.

Um efeito colateral da definição de parâmetros de instalação de classe é que o sinalizador DI_CLASSINSTALLPARAMS está definido. Se o chamador quiser definir os parâmetros, mas desabilitar seu uso, esse sinalizador deverá ser limpo por uma chamada para SetupDiSetDeviceInstallParams.

Se os parâmetros de instalação da classe forem limpos, o sinalizador DI_CLASSINSTALLPARAMS será redefinido.

Requisitos

Confira também

SetupDiGetClassInstallParams

SetupDiSetDeviceInstallParams