DIF_NEWDEVICEWIZARD_PRESELECT
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
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.
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.
Requisitos
Versión |
Compatible con Microsoft Windows 2000 y versiones posteriores de Windows. |
Encabezado |
Setupapi.h (incluir Setupapi.h) |
Consulte también
DIF_NEWDEVICEWIZARD_PREANALYZE