DIF_NEWDEVICEWIZARD_PREANALYZE
Una richiesta di DIF_NEWDEVICEWIZARD_PREANALYZE consente a un programma di installazione di fornire pagine della procedura guidata visualizzate da Windows all'utente prima di visualizzare la pagina di analisi. Questa richiesta viene usata solo durante l'installazione manuale di dispositivi non PnP.
Data di invio
Dopo che l'utente ha selezionato un driver, ma prima che Windows registri il dispositivo che rende il nodo del dispositivo (devnode) "attivo".
Chi gestisce
Co-programma di installazione classi |
Può gestire |
Programma di installazione condivisa del dispositivo |
Non gestisce |
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_NEWDEVICEWIZARD_DATA è associata a DeviceInfoData.
Output del programma di installazione
Parametri di installazione del dispositivo
Un programma di installazione può modificare i flag nei parametri di installazione del dispositivo. Windows non controlla i flag al completamento di questa richiesta DIF. Tuttavia, li controlla più avanti nel processo di installazione.
Parametri di installazione della classe
Un programma di installazione può modificare il SP_NEWDEVICEWIZARD_DATA per fornire pagine personalizzate della procedura guidata.
Valore restituito del programma di installazione
Se un co-programma di installazione non gestisce questa richiesta DIF, restituisce NO_ERROR dal passaggio di pre-elaborazione. Se un co-programma di installazione gestisce questa richiesta, può restituire NO_ERROR, ERROR_DI_POSTPROCESSING_REQUIRED o un codice di errore Win32.
Un programma di installazione classi restituisce NO_ERROR se fornisce correttamente le pagine. In caso contrario, un programma di installazione classi restituisce ERROR_DI_DO_DEFAULT o un codice di errore Win32.
Gestore di codice DIF predefinito
Nessuno
Operazione del programma di installazione
Una richiesta di DIF_NEWDEVICEWIZARD_PREANALYZE consente a un programma di installazione di fornire pagine della procedura guidata visualizzate da Windows all'utente prima di visualizzare la pagina di analisi. Queste pagine possono essere considerate come pagine "postselect". Questa richiesta viene usata solo durante l'installazione manuale di dispositivi non PnP.
Un programma di installazione può usare una pagina di preanalisi personalizzata, ad esempio, per scegliere una porta COM dopo che è stato selezionato un dispositivo modem.
Se un programma di installazione aggiunge pagine di pre-selezione personalizzate, il programma di installazione deve prima verificare se NumDynamicPages nei parametri di installazione della classe ha raggiunto MAX_INSTALLWIZARD_DYNAPAGES.
Un programma di installazione deve fornire un titolo di intestazione della procedura guidata 97 e un sottotitolo di intestazione nella struttura PROPSHEETPAGE per una pagina personalizzata della procedura guidata. Un programma di installazione non deve sostituire il titolo della procedura guidata fornita dal sistema. Per altre informazioni sulle pagine delle proprietà, vedere la Microsoft Windows SDK per la documentazione della struttura PROPSHEETPAGE.
Per altre informazioni sui codici DIF, vedere Gestione dei codici DIF.
Requisiti
Versione |
Supportato in Microsoft Windows 2000 e versioni successive di Windows. |
Intestazione |
Setupapi.h (include Setupapi.h) |