DIF_POWERMESSAGEWAKE
Una richiesta di DIF_POWERMESSAGEWAKE consente a un programma di installazione di fornire testo personalizzato visualizzato da Windows nella pagina delle proprietà di risparmio energia delle proprietà del dispositivo.
Data di invio
Quando un utente fa clic su una voce di menu o una scheda per visualizzare le proprietà di un dispositivo.
Windows invia questa richiesta DIF solo se i driver per il dispositivo supportano il risparmio energia. In caso contrario, Windows non visualizza alcuna proprietà di alimentazione per il dispositivo.
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
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_POWERMESSAGEWAKE_PARAMS è associata a DeviceInfoData.
Output del programma di installazione
Parametri di installazione della classe
Un programma di installazione può modificare il SP_POWERMESSAGEWAKE_PARAMS per fornire testo personalizzato per la pagina delle proprietà di alimentazione di un dispositivo.
Valore restituito del programma di installazione
Un co-programma di installazione restituisce in genere NO_ERROR, ERROR_DI_POSTPROCESSING_REQUIRED o un codice di errore Win32.
Un programma di installazione classi restituisce NO_ERROR se fornisce correttamente il testo delle proprietà di alimentazione. 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_POWERMESSAGEWAKE consente a un programma di installazione di fornire testo visualizzato da Windows nella pagina delle proprietà di alimentazione per un dispositivo.
Se un co-programma di installazione fornisce testo delle proprietà di alimentazione, questa operazione deve essere eseguita nella fase di post-elaborazione. Un co-programma di installazione deve prestare attenzione quando si sovrascrive il testo delle proprietà di alimentazione fornito da un programma di installazione che ha gestito la richiesta prima del co-programma di installazione.
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) |