DIF_ADDPROPERTYPAGE_ADVANCED
Una richiesta di DIF_ADDPROPERTYPAGE_ADVANCED consente a un programma di installazione di fornire una o più pagine di proprietà personalizzate per un dispositivo.
Data di invio
Quando un utente fa clic sulle proprietà di un dispositivo in Gestione dispositivi o nel Pannello di controllo.
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
Facoltativamente, fornisce un puntatore a una struttura SP_DEVINFO_DATA che identifica il dispositivo nel set di informazioni sul dispositivo. Se DeviceInfoSet è NULL, Windows richiede pagine delle proprietà per la classe di installazione del dispositivo.
Parametri di installazione del dispositivo
I parametri di installazione del dispositivo (SP_DEVINSTALL_PARAMS) sono associati a DeviceInfoData, se specificato o a DeviceInfoSet.
Parametri di installazione della classe
Una struttura SP_ADDPROPERTYPAGE_DATA è associata a DeviceInfoData, se specificato o a DeviceInfoSet.
Output del programma di installazione
Parametri di installazione del dispositivo
Un programma di installazione può modificare i parametri di installazione del dispositivo.
Parametri di installazione della classe
Un programma di installazione può modificare il SP_ADDPROPERTYPAGE_DATA per fornire pagine personalizzate.
Valore restituito del programma di installazione
Un co-programma di installazione può restituire NO_ERROR o un errore Win32. Un co-programma di installazione non deve restituire ERROR_DI_POSTPROCESSING_REQUIRED per questa richiesta DIF.
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
In risposta a questa richiesta DIF, un programma di installazione può fornire pagine di proprietà personalizzate. La gestione di questa richiesta DIF consente di specificare pagine di proprietà da un programma di installazione di classi o da un programma di installazione condivisa e rimuove la necessità di una DLL separata che funge da provider di pagine delle proprietà.
Un programma di installazione gestisce in genere questa richiesta DIF per aggiungere una nuova pagina delle proprietà specifica del dispositivo o specifica della classe di installazione. Un programma di installazione può anche sostituire la pagina delle proprietà del driver fornita dal sistema, la pagina delle proprietà della risorsa o la pagina delle proprietà di alimentazione per un dispositivo. Se un programma di installazione sostituisce una pagina fornita dal sistema, il programma di installazione deve impostare il flag appropriato nei parametri di installazione del dispositivo per il dispositivo:
DI_DRIVERPAGE_ADDED
Il programma di installazione ha fornito una pagina delle proprietà del driver.
DI_RESOURCEPAGE_ADDED
Il programma di installazione ha fornito una pagina delle proprietà della risorsa.
DI_FLAGSEX_POWERPAGE_ADDED
Il programma di installazione ha fornito una pagina delle proprietà di alimentazione.
Un programma di installazione non può sostituire la pagina delle proprietà generali fornita dal sistema.
Windows visualizza una sola pagina del driver, una pagina di risorse e una pagina di risparmio energia per un dispositivo. Un programma di installazione non deve fornire una pagina del sistema sostitutivo se un programma di installazione precedente ha già fornito una pagina di quel tipo. Questo vincolo non si applica alle pagine delle proprietà fornite dal sistema.
Un co-programma di installazione deve aggiungere pagine personalizzate nel passaggio di pre-elaborazione.
Se un programma di installazione consente a un utente di impostare una proprietà che richiede a Windows di rimuovere e riavviare il dispositivo, il programma di installazione deve impostare il flag DI_FLAGSEX_PROPCHANGE_PENDING nei parametri di installazione del dispositivo dalla routine DialogProc .
Per altre informazioni su come fornire pagine delle proprietà del dispositivo, vedere Fornire pagine delle proprietà del dispositivo.
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) |