通过

DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT回调函数 （d3dkmddi.h）

  • 项目

在新的多平面覆盖配置生效后调用，使驱动程序能够优化硬件状态。 对于支持多平面覆盖的 Windows 显示驱动程序模型 （WDDM） 2.0 或更高版本驱动程序，可选。

语法

DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT DxgkddiPostmultiplaneoverlaypresent;

NTSTATUS DxgkddiPostmultiplaneoverlaypresent(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_POSTMULTIPLANEOVERLAYPRESENT pPostPresent
)
{...}

参数

hAdapter

标识包含覆盖硬件的适配器。

pPostPresent

指向描述最近提交的新覆盖配置的 DXGKARG_POSTMULTIPLANEOVERLAYPRESENT 结构的指针。

返回值

DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT 返回以下值：

返回代码 描述
STATUS_SUCCESS 如果例程已成功完成。 驱动程序应始终返回成功代码。 失败将导致 bug 检查。

言论

此函数从 PASSIVE 级别调用。

仅当驱动程序在 VSYNC 回调中设置 DXGKARGCB_NOTIFY_INTERRUPT_DATA 结构 DXGKCB_NOTIFY_MPO_VSYNC_FLAGS 成员的 PostPresentNeeded 时，才会调用此函数。

驱动程序可以使用此功能来降低电压级别、时钟、FIFO 深度或任何其他可节省电源的优化。

驱动程序不应在此调用中花费大量时间，因为调用会阻止主 GPU 计划程序线程和延迟可能导致出现故障。 时间密集型作应按驱动程序排入队列，并在后台进行处理。 在此方案中，队列项与未来预/后调用所需的硬件更改之间的任何冲突都应由驱动程序管理。

要求

要求 价值
目标平台 窗户
标头 d3dkmddi.h