DIF_NEWDEVICEWIZARD_PREANALYZE

Artículo
06/15/2023

Una solicitud de DIF_NEWDEVICEWIZARD_PREANALYZE permite que un instalador proporcione páginas del asistente que Windows muestra al usuario antes de mostrar la página de análisis. Esta solicitud solo se usa durante la instalación manual de dispositivos que no son PnP.

Cuándo se envió

Después de que el usuario haya seleccionado un controlador, pero antes de que Windows registre el dispositivo que hace que el nodo del dispositivo (devnode) esté "activo".

Quién controla

Co-instalador de clase	Puede controlar
Instalador co-instalador del dispositivo	No controla
Instalador de clase	Puede controlar

Entrada del instalador

DeviceInfoSet
Proporciona un identificador al conjunto de información del dispositivo que contiene el dispositivo.

DeviceInfoData
Proporciona un puntero a una estructura de SP_DEVINFO_DATA que identifica el dispositivo en el conjunto de información del dispositivo.

Parámetros de instalación de dispositivos
Hay parámetros de instalación de dispositivos (SP_DEVINSTALL_PARAMS) asociados a DeviceInfoData.

Parámetros de instalación de clases
Una estructura de SP_NEWDEVICEWIZARD_DATA está asociada a DeviceInfoData.

Salida del instalador

Parámetros de instalación de dispositivos
Un instalador puede modificar las marcas en los parámetros de instalación del dispositivo. Windows no comprueba las marcas tras la finalización de esta solicitud DIF. Sin embargo, los comprueba más adelante en el proceso de instalación.

Parámetros de instalación de clases
Un instalador puede modificar el SP_NEWDEVICEWIZARD_DATA para proporcionar páginas de asistente personalizadas.

Valor devuelto del instalador

Si un co-instalador no controla esta solicitud DIF, devuelve NO_ERROR de su paso de preprocesamiento. Si un co-instalador controla esta solicitud, puede devolver NO_ERROR, ERROR_DI_POSTPROCESSING_REQUIRED o un código de error win32.

Un instalador de clase devuelve NO_ERROR si proporciona correctamente páginas. De lo contrario, un instalador de clase devuelve ERROR_DI_DO_DEFAULT o un código de error win32.

Controlador de código DIF predeterminado

Ninguno

Operación del instalador

Una solicitud de DIF_NEWDEVICEWIZARD_PREANALYZE permite que un instalador proporcione páginas del asistente que Windows muestra al usuario antes de mostrar la página de análisis. Estas páginas se pueden considerar como páginas "postselect". Esta solicitud solo se usa durante la instalación manual de dispositivos que no son PnP.

Un instalador puede usar una página de preanalyze personalizada, por ejemplo, para elegir un puerto COM después de seleccionar un dispositivo módem.

Si un instalador agrega páginas preseleccionadas personalizadas, el instalador debe comprobar primero si NumDynamicPages en los parámetros de instalación de clase ha alcanzado MAX_INSTALLWIZARD_DYNAPAGES.

Un instalador debe proporcionar un título de encabezado del Asistente 97 y un subtítulo de encabezado en la estructura PROPSHEETPAGE para una página del asistente personalizado. Un instalador no debe reemplazar el título del asistente proporcionado por el sistema. Consulte la Microsoft Windows SDK para obtener documentación de la estructura PROPSHEETPAGE y para obtener más información sobre las páginas de propiedades.

Para obtener más información sobre los códigos DIF, consulte Control de códigos DIF.