структура 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) |