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