DIF_TROUBLESHOOTER
La richiesta di DIF_TROUBLESHOOTER consente a un programma di installazione di avviare uno strumento di risoluzione dei problemi per un dispositivo o di restituire i file dello strumento di risoluzione dei problemi CHM e HTM per l'avvio di Windows.
Nota Questo codice DIF è supportato solo in Windows Server 2003, Windows XP e Microsoft Windows 2000.
Data di invio
Quando un utente fa clic sul pulsante "Strumento di risoluzione dei problemi" per un dispositivo in Gestione dispositivi.
Chi gestisce
Co-programma di installazione classi |
Può gestire |
Programma di installazione condivisa del dispositivo |
Può gestire |
Programma di installazione classi |
Può gestire |
Input del programma di installazione
DeviceInfoSet
Fornisce un handle al set di informazioni sul dispositivo che contiene il dispositivo.
DeviceInfoData
Fornisce un puntatore a una struttura SP_DEVINFO_DATA che identifica il dispositivo nel set di informazioni sul dispositivo.
Parametri di installazione del dispositivo
Esistono parametri di installazione del dispositivo (SP_DEVINSTALL_PARAMS) associati a DeviceInfoData.
Parametri di installazione della classe
Una struttura SP_TROUBLESHOOTER_PARAMS è associata a DeviceInfoData.
Output del programma di installazione
Parametri di installazione della classe
Un programma di installazione potrebbe modificare la SP_TROUBLESHOOTER_PARAMS, impostando un file CHM o HTML.
Valore restituito del programma di installazione
Se un co-programma di installazione non gestisce questa richiesta, restituisce NO_ERROR dal passaggio di pre-elaborazione.
Se un co-programma di installazione gestisce questa richiesta, la richiesta viene eseguita nel passaggio di post-elaborazione. Se il co-programma di installazione fornisce file CHM e HTML, propaga lo stato ricevuto (probabilmente ERROR_DI_DO_DEFAULT). Se il co-programma di installazione esegue uno strumento di risoluzione dei problemi e risolve il problema, il co-programma di installazione restituisce NO_ERROR. Se il co-programma di installazione esegue uno strumento di risoluzione dei problemi ma non risolve il problema, propaga lo stato ricevuto (ERROR_DI_DO_DEFAULT).
Se un programma di installazione classi fornisce un file CHM e un file HTML o il programma di installazione della classe esegue uno strumento di risoluzione dei problemi ma non risolve il problema, il programma di installazione della classe restituisce ERROR_DI_DO_DEFAULT. Windows chiamerà successivamente il gestore predefinito.
Se un programma di installazione di classe avvia il proprio strumento di risoluzione dei problemi e risolve il problema, il programma di installazione della classe restituisce NO_ERROR. Windows non chiamerà successivamente il gestore predefinito.
Se il programma di installazione della classe rileva un errore, il programma di installazione restituisce un codice di errore Win32 appropriato. Windows non chiamerà successivamente il gestore predefinito.
Gestore di codice DIF predefinito
Nessuno
Non esiste alcun gestore predefinito per DIF_TROUBLESHOOTER, ma il sistema operativo fornisce strumenti di risoluzione dei problemi predefiniti che tentano di risolvere i problemi del dispositivo se non sono presenti strumenti di risoluzione dei problemi forniti dal programma di installazione.
Operazione del programma di installazione
Un programma di installazione chiama CM_Get_DevNode_Status per ottenere lo stato del dispositivo e il codice del problema cm. A seconda del problema, un programma di installazione potrebbe fornire uno strumento di risoluzione dei problemi, un file della Guida o nulla. Uno strumento di risoluzione dei problemi può risolvere un problema con un dispositivo. Se uno strumento di risoluzione dei problemi risolve il problema, deve chiamare SetupDiCallClassInstaller per inviare una richiesta di DIF_PROPERTYCHANGE di tipo DICS_PROPCHANGE. Se un programma di installazione non fornisce uno strumento di risoluzione dei problemi per un dispositivo, potrebbe fornire un file della Guida di suggerimenti per la risoluzione dei problemi per l'utente.
Se nessun programma di installazione esegue uno strumento di risoluzione dei problemi specifico, Windows esegue la Guida HTML per visualizzare le informazioni all'utente. Se un programma di installazione ha fornito un file CHM nei parametri di installazione della classe, Windows visualizza tale file. In caso contrario, Windows visualizza informazioni sulla risoluzione dei problemi fornite dal sistema.
I parametri di installazione della classe contengono al massimo una coppia ChmFile e HtmlTroubleShooter . Se più programmi di installazione specificano questi valori, Windows usa i valori impostati dall'ultimo programma di installazione che ha gestito la richiesta DIF.
Per altre informazioni sui codici DIF, vedere Gestione dei codici DIF.
Requisiti
Versione |
Supportato in Windows Server 2003, Windows XP e Microsoft Windows 2000. |
Intestazione |
Setupapi.h (include Setupapi.h) |