DIF_NEWDEVICEWIZARD_PRESELECT

Artículo
06/15/2023

Una solicitud de DIF_NEWDEVICEWIZARD_PRESELECT permite que un instalador proporcione páginas del asistente que Windows muestra al usuario antes de mostrar la página select-driver. 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 la clase para el dispositivo, pero antes de Que Windows muestre la página "Seleccionar un controlador de 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 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 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

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 co-instalador puede agregar páginas personalizadas en su paso de preprocesamiento o en su paso posterior al procesamiento. Si agrega páginas en su paso de preprocesamiento, esas páginas se muestran antes que las páginas proporcionadas por el instalador de clase.

Si uno o varios instaladores agregan páginas preseleccionados personalizadas, Windows muestra las páginas antes de la página "Seleccionar un controlador de dispositivo". Sin embargo, si el usuario presiona "Atrás" en la página select-driver, Windows omite las páginas preseleccionas personalizadas y vuelve a la página de selección de clases "Tipo de hardware".

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.