estructura de SP_NEWDEVICEWIZARD_DATA (setupapi.h)

Artículo
03/15/2023

Los instaladores usan una estructura de SP_NEWDEVICEWIZARD_DATA para ampliar el funcionamiento del asistente para la instalación de hardware mediante la adición de páginas personalizadas. Se usa con solicitudes de instalación DIF_NEWDEVICEWIZARD_XXX .

Sintaxis

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;

Miembros

ClassInstallHeader

Encabezado de solicitud de instalación que contiene el tamaño del encabezado y el código DIF para la solicitud. Consulte SP_CLASSINSTALL_HEADER.

Flags

Reservado. Debe ser cero.

DynamicPages[MAX_INSTALLWIZARD_DYNAPAGES]

Matriz de identificadores de página de hoja de propiedades. Un instalador puede agregar los identificadores de las páginas del asistente personalizadas a esta matriz.

NumDynamicPages

Número de páginas que se agregan a la matriz DynamicPages .

Dado que el índice de matriz está basado en cero, este valor también es el índice para la siguiente entrada libre de la matriz. Por ejemplo, si hay 3 páginas en la matriz, DynamicPages[3] es la siguiente entrada para que un instalador lo use.

hwndWizardDlg

Identificador de la ventana de nivel superior del Asistente para instalación de hardware.