PDXGK_POWER_NOTIFICATION回调函数 (d3dkmthk.h)

  • 项目

一个回调，用于通知图形设备将经历设备电源状态转换。

语法

PDXGK_POWER_NOTIFICATION PdxgkPowerNotification;

void PdxgkPowerNotification(
  PVOID GraphicsDeviceHandle,
  DEVICE_POWER_STATE NewGrfxPowerState,
  BOOLEAN PreNotification,
  PVOID PrivateHandle
)
{...}

参数

GraphicsDeviceHandle

对图形设备进行回调时应提供的不透明句柄。

NewGrfxPowerState

一个DEVICE_POWER_STATE值，该值指示正在设置过程中的新图形电源状态。

PreNotification

指示是否应提供通知的布尔值。

PrivateHandle

在任何回调中提供的不透明句柄。 此句柄必须全局唯一，因此应使用指向调用驱动程序的 PDO 或 FDO 的指针。

返回值

无

备注

此回调是在PASSIVE_LEVEL进行的。 仅当新的电源状态为 PowerDeviceD3 时，驱动程序才能阻止以完成操作的服务。 在这种情况下，调用仍必须及时完成，因为它可能会阻止完成整个设备电源状态转换，并可能导致电源监视器 bug 检查。 当新状态为 PowerDeviceD0 时，驱动程序不得阻止。 进入 PowerDeviceD3 时，系统会同时提供“pre”和“post”通知，前提是过渡期间不会取消。 进入 PowerDeviceD0 时，只会提供“发布”通知。 如果需要，允许此回调处理程序调用 SetSharedPowerComponentStateCb 图形回调;此处理程序不允许对图形内核进行其他回调。

重要

初始图形电源状态将在 IOCTL 输出中提供，但是，由于在注册发生时图形设备可能正在经历电源状态转换，因此必须围绕 IOCTL 调用和分析原始状态获取互斥体，并且必须在此回调函数中获取相同的互斥体。 这样，如果状态正在转换，则回调将提供最新的状态信息。

要求

要求 值
最低受支持的客户端 Windows 8
最低受支持的服务器 Windows Server 2012
目标平台 Windows
标头 d3dkmthk.h
IRQL <= PASSIVE_LEVEL

另请参阅

DEVICE_POWER_STATE