PDXGK_FSTATE_NOTIFICATION回调函数 (d3dkmthk.h)

  • 项目

由客户端驱动程序实现以发出状态通知。

语法

PDXGK_FSTATE_NOTIFICATION PdxgkFstateNotification;

void PdxgkFstateNotification(
  PVOID GraphicsDeviceHandle,
  ULONG ComponentIndex,
  UINT NewFState,
  BOOLEAN PreNotification,
  PVOID PrivateHandle
)
{...}

参数

GraphicsDeviceHandle

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

ComponentIndex

组件的索引。 通常，这是图形适配器使用的索引。 LDA 方案例外，其中 ComponentIndex 的 HIWORD 指示适配器索引，就像图形内核调用图形驱动程序以更改 LDA 方案中的 F 状态时一样。

NewFState

要转换到的 F 状态。

PreNotification

指示应提供通知。

PrivateHandle

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

返回值

无

备注

从 Dxgkrnl 到此回调的所有回调最多可以调用DISPATCH_LEVEL (例如，非图形驱动程序不应阻止任何这些通知) 。 仅对 DXGK_POWER_COMPONENT_SHARED 类型的电源组件进行回调。

在转换 F 状态之前，将提供预通知。 完成通知回调 (PreNotification==FALSE) 作为图形驱动程序 DxgkCbCompleteFStateTransition 回调的一部分发出。 也就是说，在 DxgkCbCompleteFStateTransition 返回之前，所有共享电源组件都将收到 F 状态转换完成的通知。

要求

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