通过

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 时，将仅提供“post”通知。 允许此回调处理程序根据需要调用 SetSharedPowerComponentStateCb 图形回调;此处理程序不允许对图形内核进行其他回调。

重要

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

要求

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

另请参阅

DEVICE_POWER_STATE