DIF_POWERMESSAGEWAKE
Una solicitud de DIF_POWERMESSAGEWAKE permite a un instalador proporcionar texto personalizado que Windows muestra en la página de propiedades de administración de energía de las propiedades del dispositivo.
Cuándo se envió
Cuando un usuario hace clic en un elemento de menú o pestaña para mostrar las propiedades de un dispositivo.
Windows solo envía esta solicitud de DIF si los controladores para la administración de energía del dispositivo admiten la administración de energía. De lo contrario, Windows no muestra ninguna propiedad de energía para el dispositivo.
Quién controla
Coinserción de clase |
Puede controlar |
Instalador conjunta del dispositivo |
Puede controlar |
Instalador de clase |
Puede controlar |
Entrada del instalador
DeviceInfoSet
Proporciona un identificador al conjunto de información del dispositivo que contiene el dispositivo.
DeviceInfoData
Proporciona un puntero a una estructura de SP_DEVINFO_DATA que identifica el dispositivo en el conjunto de información del dispositivo.
Parámetros de instalación de dispositivos
Hay parámetros de instalación de dispositivos (SP_DEVINSTALL_PARAMS) asociados a DeviceInfoData.
Parámetros de instalación de clases
Una estructura de SP_POWERMESSAGEWAKE_PARAMS está asociada a DeviceInfoData.
Salida del instalador
Parámetros de instalación de clases
Un instalador puede modificar el SP_POWERMESSAGEWAKE_PARAMS para proporcionar texto personalizado para la página de propiedades de energía de un dispositivo.
Valor devuelto del instalador
Normalmente, un co-instalador devuelve NO_ERROR, ERROR_DI_POSTPROCESSING_REQUIRED o un código de error win32.
Un instalador de clase devuelve NO_ERROR si proporciona correctamente texto de propiedades de energía. De lo contrario, un instalador de clase devuelve ERROR_DI_DO_DEFAULT o un código de error win32.
Controlador de código DIF predeterminado
Ninguno
Operación del instalador
Una solicitud de DIF_POWERMESSAGEWAKE permite a un instalador proporcionar texto que Windows muestra en la página de propiedades de energía de un dispositivo.
Si un co-instalador proporciona texto de propiedades de energía, debe hacerlo en su fase de postprocesamiento. Un co-instalador debe tener cuidado al sobrescribir cualquier texto de propiedades de energía proporcionado por un instalador que controle la solicitud antes del co-instalador.
Para obtener más información sobre los códigos DIF, consulte Control de códigos DIF.
Requisitos
Versión |
Compatible con Microsoft Windows 2000 y versiones posteriores de Windows. |
Encabezado |
Setupapi.h (incluya Setupapi.h) |