DIF_NEWDEVICEWIZARD_POSTANALYZE

Artículo
06/15/2023

Una solicitud de DIF_NEWDEVICEWIZARD_POSTANALYZE permite que un instalador proporcione páginas del asistente que Windows muestra al usuario después de registrar el nodo de dispositivo (nodo de desarrollo), pero antes de que Windows instale los controladores para el dispositivo. Esta solicitud solo se usa durante la instalación manual de dispositivos que no son PnP.

Cuándo se envió

Después de que Windows registre el dispositivo, lo que hace que el nodo de desarrollo se "active", pero antes de que Windows instale los controladores para el dispositivo.

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 comprobará 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 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_POSTANALYZE permite que un instalador proporcione páginas del asistente que Windows muestra al usuario después de registrar el nodo de desarrollo, pero antes de que Windows instale los controladores para el dispositivo. Esta solicitud solo se usa durante la instalación manual de dispositivos que no son PnP.

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

Después de que el usuario haga clic en Siguiente en una página personalizada, Windows instala los controladores para el dispositivo y el administrador de PnP inicia el dispositivo. Una página del asistente postanalyze es la última oportunidad de que un instalador realice el trabajo antes de cargar los controladores y se inicie el dispositivo.

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.