DIF_NEWDEVICEWIZARD_PRESELECT
Una richiesta DIF_NEWDEVICEWIZARD_PRESELECT consente a un programma di installazione di specificare le pagine della procedura guidata visualizzate dall'utente prima di visualizzare la pagina select-driver. Questa richiesta viene usata solo durante l'installazione manuale di dispositivi non PnP.
Data di invio
Dopo che l'utente ha selezionato la classe per il dispositivo, ma prima che Windows visualizzi la pagina "Seleziona un driver di dispositivo".
Chi gestisce
Co-installer di classe |
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 del 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
Sono disponibili 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.
Valore restituito dal programma di installazione
Se un co-installer non gestisce questa richiesta DIF, restituisce NO_ERROR dal passaggio di pre-elaborazione. Se un co-installer gestisce questa richiesta, può restituire NO_ERROR, ERROR_DI_POSTPROCESSING_REQUIRED o un codice di errore Win32.
Un programma di installazione della classe restituisce NO_ERROR se fornisce correttamente le pagine. In caso contrario, un programma di installazione della classe restituisce ERROR_DI_DO_DEFAULT o un codice di errore Win32.
Gestore di codice DIF predefinito
Nessuno
Operazione del programma di installazione
Una richiesta DIF_NEWDEVICEWIZARD_PRESELECT consente a un programma di installazione di specificare le pagine della procedura guidata visualizzate dall'utente prima di visualizzare la pagina select-driver. Questa richiesta viene usata solo durante l'installazione manuale di dispositivi non PnP.
Se un programma di installazione aggiunge pagine di selezione predefinite personalizzate, il programma di installazione deve prima verificare se NumDynamicPages nei parametri di installazione della classe ha raggiunto MAX_INSTALLWIZARD_DYNAPAGES.
Un co-programma di installazione può aggiungere pagine personalizzate nel passaggio di pre-elaborazione e/o nel passaggio di post-elaborazione. Se aggiunge pagine nel passaggio di pre-elaborazione, tali pagine vengono visualizzate prima di qualsiasi pagina fornita dal programma di installazione della classe.
Se uno o più programmi di installazione aggiungono pagine predefinite personalizzate, Windows visualizza le pagine prima della pagina "Seleziona un driver di dispositivo". Tuttavia, se l'utente preme "Indietro" nella pagina select-driver, Windows ignora le pagine di selezione predefinite personalizzate e torna alla pagina di selezione della classe "Tipo hardware".
Un programma di installazione deve specificare un titolo di intestazione guidata 97 e un sottotitolo di intestazione nella struttura PROPSHEETPAGE per una pagina guidata personalizzata. 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) |
Vedi anche
DIF_NEWDEVICEWIZARD_PREANALYZE