DIF_NEWDEVICEWIZARD_PRESELECT

Articolo
06/15/2023

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

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.