DIF_NEWDEVICEWIZARD_SELECT

Articolo
06/15/2023

Una richiesta di DIF_NEWDEVICEWIZARD_SELECT consente a un programma di installazione di specificare pagine personalizzate della procedura guidata che sostituiscono la pagina select-driver standard. Questa richiesta viene usata solo durante l'installazione manuale di dispositivi non PnP.

Data di invio

Immediatamente prima che Windows visualizzi la pagina "Seleziona un driver di dispositivo".

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.

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

Un programma di installazione risponde a questa richiesta DIF per sostituire completamente la pagina della procedura guidata select-driver standard. Se, invece, il programma di installazione deve solo modificare la pagina standard o modificare l'elenco di driver da cui scegliere, il programma di installazione deve farlo in risposta alla richiesta di DIF_SELECTDEVICE .

Un co-programma di installazione deve aggiungere pagine personalizzate nel passaggio di post-elaborazione e solo se il programma di installazione della classe non ha aggiunto pagine personalizzate. Se il programma di installazione della classe ha aggiunto le pagine, il co-programma di installazione non deve essere. In caso contrario, potrebbe essere richiesto all'utente di scegliere un driver due volte.

Se un programma di installazione fornisce una pagina di selezione personalizzata, il programma di installazione deve impostare il driver selezionato. Nel codice del programma di installazione che supporta la pagina della procedura guidata, dopo che l'utente fa clic su Avanti, il programma di installazione deve chiamare SetupDiSetSelectedDriver.

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.