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

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 для текущего активного запроса на установку устройства.

Требования

Требование	Значение
Заголовок	setupapi.h (включая Setupapi.h)

См. также раздел

SP_DETECTDEVICE_PARAMS

SP_MOVEDEV_PARAMS

SP_NEWDEVICEWIZARD_DATA

SP_POWERMESSAGEWAKE_PARAMS

SP_PROPCHANGE_PARAMS

SP_REMOVEDEVICE_PARAMS

SP_SELECTDEVICE_PARAMS

SP_TROUBLESHOOTER_PARAMS

SP_UNREMOVEDEVICE_PARAMS

SetupDiCallClassInstaller

SetupDiGetClassInstallParams

SetupDiSetClassInstallParams