estrutura SP_CLASSINSTALL_HEADER (setupapi.h)

Artigo
03/01/2024

Um SP_CLASSINSTALL_HEADER é o primeiro membro de qualquer estrutura de parâmetros de instalação de classe. Ele contém o código de solicitação de instalação do dispositivo que define o formato do restante da estrutura de parâmetros de instalação.

Sintaxe

typedef struct _SP_CLASSINSTALL_HEADER {
  DWORD       cbSize;
  DI_FUNCTION InstallFunction;
} SP_CLASSINSTALL_HEADER, *PSP_CLASSINSTALL_HEADER;

Membros

cbSize

O tamanho, em bytes, da estrutura SP_CLASSINSTALL_HEADER.

InstallFunction

A solicitação de instalação do dispositivo (código DIF) para a estrutura de parâmetros de instalação de classe.

Os códigos DIF têm o formato DIF_XXX e são definidos em Setupapi.h. Consulte Códigos de função de instalação do dispositivo para obter uma descrição completa dos códigos DIF.

Comentários

Quando um componente aloca uma estrutura de parâmetros de instalação de classe, ele normalmente inicializa os campos de cabeçalho da estrutura. Esse componente define o membro InstallFunction como o código DIF para a solicitação de instalação e define cbSize como o tamanho da estrutura SP_CLASSINSTALL_HEADER. Por exemplo:

SP_REMOVEDEVICE_PARAMS RemoveDeviceParams;
RemoveDeviceParams.ClassInstallHeader.cbSize = sizeof(SP_CLASSINSTALL_HEADER);
RemoveDeviceParams.ClassInstallHeader.InstallFunction = DIF_REMOVE;

Um componente deve definir o membro InstallFunction antes de passar uma estrutura de parâmetros de instalação de classe para SetupDiSetClassInstallParams.

No entanto, um componente não precisa definir esse campo ao passar parâmetros de instalação de classe para SetupDiGetClassInstallParams. Essa função define o membro InstallFunction na estrutura que ele passa de volta para o chamador. Ele define InstallFunction como o código DIF_XXX para a solicitação de instalação do dispositivo atualmente ativa.