Função SetupDiGetClassInstallParamsA (setupapi.h)

A função SetupDiGetClassInstallParams recupera 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 SetupDiGetClassInstallParamsA(
  [in]            HDEVINFO                DeviceInfoSet,
  [in, optional]  PSP_DEVINFO_DATA        DeviceInfoData,
  [out, optional] PSP_CLASSINSTALL_HEADER ClassInstallParams,
  [in]            DWORD                   ClassInstallParamsSize,
  [out, optional] PDWORD                  RequiredSize
);

Parâmetros

[in] DeviceInfoSet

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

[in, optional] DeviceInfoData

Um ponteiro para uma estrutura de SP_DEVINFO_DATA que especificou um elemento de informações do dispositivo em deviceInfoSet. Esse parâmetro é opcional e pode ser NULL. Se esse parâmetro for especificado, SetupDiGetClassInstallParams recuperará os parâmetros de instalação de classe para o dispositivo especificado. Se esse parâmetro for NULL, SetupDiGetClassInstallParams recuperará os parâmetros de instalação de classe para a lista de driver de classe global associada a DeviceInfoSet.

[out, optional] ClassInstallParams

Um ponteiro para um buffer que contém uma estrutura SP_CLASSINSTALL_HEADER. Essa estrutura deve ter seu cbSize membro definido como sizeof(SP_CLASSINSTALL_HEADER) na entrada ou o buffer é considerado inválido. Na saída, o membro InstallFunction é preenchido com o código da função de instalação do dispositivo para os parâmetros de instalação de classe que estão sendo recuperados. Se o buffer for grande o suficiente, ele também receberá a estrutura de parâmetros de instalação de classe específica para o código da função. Se ClassInstallParams não for especificado, ClassInstallParamsSize deverá ser 0.

[in] ClassInstallParamsSize

O tamanho, em bytes, do buffer ClassInstallParams. Se o buffer for fornecido, ele deverá ser pelo menos tão grande quanto sizeof(SP_CLASSINSTALL_HEADER). Se o buffer não for fornecido, ClassInstallParamsSize deverá ser 0.

[out, optional] RequiredSize

Um ponteiro para uma variável do tipo DWORD que recebe o número de bytes necessários para armazenar os parâmetros de instalação da classe. Esse parâmetro é opcional e pode ser NULL.

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

Os parâmetros de instalação de classe são específicos para um código de função de instalação de dispositivo específico armazenado no campo ClassInstallHeader de localizado no início do buffer ClassInstallParams do .

Requisitos

Consulte também

SetupDiSetClassInstallParams