DIF_NEWDEVICEWIZARD_SELECT

Artículo
06/15/2023

Una solicitud de DIF_NEWDEVICEWIZARD_SELECT permite que un instalador proporcione páginas del asistente personalizadas que reemplacen la página estándar select-driver. Esta solicitud solo se usa durante la instalación manual de dispositivos que no son PnP.

Cuándo se envió

Inmediatamente antes de que Windows muestre la página "Seleccionar un controlador de dispositivo".

Quién controla

Coinserción de clase	Puede controlar
Instalador conjunta 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 completar esta solicitud de 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

Un instalador responde a esta solicitud de DIF para reemplazar completamente la página del asistente para seleccionar controladores estándar. Si, en su lugar, el instalador solo tiene que modificar la página estándar o modificar la lista de controladores de los que elegir, el instalador debe hacerlo en respuesta a la solicitud de DIF_SELECTDEVICE .

Un coinserador debe agregar páginas personalizadas en su paso de postprocesamiento y solo si el instalador de clase no agregó páginas personalizadas. Si el instalador de clase ha agregado páginas, el co-instalador no debe. De lo contrario, es posible que se le pida al usuario que elija un controlador dos veces.

Si un instalador proporciona una página de selección personalizada, el instalador debe establecer el controlador seleccionado. En el código del instalador que admite la página del asistente, después de que el usuario haga clic en Siguiente, el instalador debe llamar a SetupDiSetSelectedDriver.

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 personalizada. 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.