DIF_TROUBLESHOOTER

Artículo
06/14/2023

La solicitud de DIF_TROUBLESHOOTER permite que un instalador inicie un solucionador de problemas de un dispositivo o que devuelva archivos del solucionador de problemas CHM y HTM para que Windows se inicie.

Nota Este código DIF solo se admite en Windows Server 2003, Windows XP y Microsoft Windows 2000.

Cuándo se envió

Cuando un usuario hace clic en el botón "Solucionador de problemas" de un dispositivo en Administrador de dispositivos.

Quién controla

Co-instalador de clase	Puede controlar
Instalador co-instalador del dispositivo	Puede controlar
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_TROUBLESHOOTER_PARAMS está asociada a DeviceInfoData.

Salida del instalador

Parámetros de instalación de clases
Un instalador puede modificar el SP_TROUBLESHOOTER_PARAMS, estableciendo un archivo CHM o HTML.

Valor devuelto del instalador

Si un co-instalador no controla esta solicitud, devuelve NO_ERROR de su paso de preprocesamiento.

Si un co-instalador controla esta solicitud, lo hace en su paso posterior al procesamiento. Si el co-instalador proporciona archivos CHM y HTML, propaga el estado que recibió (probablemente ERROR_DI_DO_DEFAULT). Si el co-instalador ejecuta un solucionador de problemas y corrige el problema, el co-instalador devuelve NO_ERROR. Si el co-instalador ejecuta un solucionador de problemas pero no corrige el problema, propaga el estado que recibió (ERROR_DI_DO_DEFAULT).

Si un instalador de clase proporciona un archivo CHM y un archivo HTML, o el instalador de clase ejecuta un solucionador de problemas pero no corrige el problema, el instalador de clase devuelve ERROR_DI_DO_DEFAULT. Windows llamará posteriormente al controlador predeterminado.

Si un instalador de clase inicia su propio solucionador de problemas y corrige el problema, el instalador de clase devuelve NO_ERROR. Windows no llamará posteriormente al controlador predeterminado.

Si el instalador de clase encuentra un error, el instalador devuelve un código de error de Win32 adecuado. Windows no llamará posteriormente al controlador predeterminado.

Controlador de código DIF predeterminado

Ninguno

No hay ningún controlador predeterminado para DIF_TROUBLESHOOTER, pero el sistema operativo proporciona solucionadores de problemas predeterminados que intentan resolver problemas de dispositivo si no hay solucionadores de problemas proporcionados por el instalador.

Operación del instalador

Un instalador llama a CM_Get_DevNode_Status para obtener el estado del dispositivo y el código del problema de CM. Dependiendo del problema, un instalador puede proporcionar un solucionador de problemas, un archivo de ayuda o nada. Un solucionador de problemas puede resolver un problema con un dispositivo. Si un solucionador de problemas resuelve el problema, debe llamar a SetupDiCallClassInstaller para enviar una solicitud de DIF_PROPERTYCHANGE de tipo DICS_PROPCHANGE. Si un instalador no proporciona un solucionador de problemas para un dispositivo, puede proporcionar un archivo de ayuda de sugerencias de resolución de problemas para el usuario.

Si ningún instalador ejecuta su propio solucionador de problemas, Windows ejecuta la Ayuda HTML para mostrar información al usuario. Si un instalador proporcionó un archivo CHM en los parámetros de instalación de clase, Windows muestra ese archivo. De lo contrario, Windows muestra información de solución de problemas proporcionada por el sistema.

Los parámetros de instalación de clase contienen como máximo un par ChmFile y HtmlTroubleShooter . Si más de un instalador especifica estos valores, Windows usa los valores establecidos por el último instalador que controló la solicitud DIF.

Para obtener más información sobre los códigos DIF, consulte Control de códigos DIF.