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

Статья
08/26/2023

Структура SP_NEWDEVICEWIZARD_DATA используется установщиками для расширения работы мастера установки оборудования путем добавления настраиваемых страниц. Он используется с запросами на установку DIF_NEWDEVICEWIZARD_XXX .

Синтаксис

typedef struct _SP_NEWDEVICEWIZARD_DATA {
  SP_CLASSINSTALL_HEADER ClassInstallHeader;
  DWORD                  Flags;
  HPROPSHEETPAGE         DynamicPages[MAX_INSTALLWIZARD_DYNAPAGES];
  DWORD                  NumDynamicPages;
  HWND                   hwndWizardDlg;
} SP_NEWDEVICEWIZARD_DATA, *PSP_NEWDEVICEWIZARD_DATA;

Члены

ClassInstallHeader

Заголовок запроса на установку, содержащий размер заголовка и код DIF для запроса. См . SP_CLASSINSTALL_HEADER.

Flags

Зарезервировано. Должен равняться нулю.

DynamicPages[MAX_INSTALLWIZARD_DYNAPAGES]

Массив дескрипторов страницы листа свойств. Установщик может добавить в этот массив дескрипторы настраиваемых страниц мастера.

NumDynamicPages

Количество страниц, добавляемых в массив DynamicPages .

Так как индекс массива отсчитывается от нуля, это значение также является индексом следующей свободной записи в массиве. Например, если в массиве 3 страницы, DynamicPages[3] — это следующая запись для использования установщиком.

hwndWizardDlg

Дескриптор для окна верхнего уровня мастера установки оборудования .