структура SP_CLASSINSTALL_HEADER (setupapi.h)

Статья
03/01/2024

SP_CLASSINSTALL_HEADER является первым членом любой структуры параметров установки класса. Он содержит код запроса на установку устройства, определяющий формат остальной структуры параметров установки.

Синтаксис

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

Члены

cbSize

Размер структуры SP_CLASSINSTALL_HEADER в байтах.

InstallFunction

Запрос на установку устройства (код DIF) для структуры параметров установки класса.

Коды DIF имеют формат DIF_XXX и определяются в Setupapi.h. Полное описание кодов DIF см. в разделе Коды функций установки устройств .

Когда компонент выделяет структуру параметров установки класса, он обычно инициализирует поля заголовка структуры. Такой компонент задает член InstallFunction в код DIF для запроса на установку и задает cbSize размер структуры SP_CLASSINSTALL_HEADER. Пример:

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

Компонент должен задать элемент InstallFunction перед передачей структуры параметров установки класса в SetupDiSetClassInstallParams.

Однако компоненту не нужно задавать это поле при передаче параметров установки класса в SetupDiGetClassInstallParams. Эта функция задает элемент InstallFunction в структуре, которую она передает обратно вызывающему объекту. Он задает для InstallFunction код DIF_XXX для текущего активного запроса на установку устройства.