DIF_POWERMESSAGEWAKE

DIF_POWERMESSAGEWAKE请求允许安装程序提供 Windows 在设备属性的电源管理属性页上显示的自定义文本。

发送时

当用户单击菜单项或选项卡以显示设备的属性时。

仅当设备的驱动程序支持电源管理时,Windows 才会发送此 DIF 请求。 否则,Windows 不会显示设备的任何电源属性。

谁处理

类共同安装程序

可以处理

设备共同安装程序

可以处理

类安装程序

可以处理

安装程序输入

DeviceInfoSet
为包含 该设备的设备信息集 提供句柄。

DeviceInfoData
提供指向 SP_DEVINFO_DATA 结构的指针,该结构标识设备信息集中的设备。

设备安装参数
设备安装参数 (SP_DEVINSTALL_PARAMS) 与 DeviceInfoData 相关联。

类安装参数
SP_POWERMESSAGEWAKE_PARAMS结构与 DeviceInfoData 相关联。

安装程序输出

类安装参数
安装程序可以修改 SP_POWERMESSAGEWAKE_PARAMS ,为设备的电源属性页提供自定义文本。

安装程序返回值

共同安装程序通常返回NO_ERROR、ERROR_DI_POSTPROCESSING_REQUIRED或 Win32 错误代码。

如果类安装程序成功提供电源属性文本,则返回NO_ERROR。 否则,类安装程序将返回ERROR_DI_DO_DEFAULT或 Win32 错误代码。

默认 DIF 代码处理程序

安装程序操作

DIF_POWERMESSAGEWAKE请求允许安装程序提供 Windows 在设备的电源属性页面上显示的文本。

如果共同安装程序提供 power-properties 文本,则应在其后处理阶段执行此操作。 在覆盖由在共同安装程序之前处理请求的安装程序提供的任何电源属性文本时,共同安装程序应小心。

有关 DIF 代码的详细信息,请参阅 处理 DIF 代码

要求

版本

在 Microsoft Windows 2000 及更高版本的 Windows 中受支持。

标头

Setupapi.h (包括 Setupapi.h)

另请参阅

SP_DEVINFO_DATA

SP_DEVINSTALL_PARAMS

SP_POWERMESSAGEWAKE_PARAMS