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 计划程序线程main，延迟可能会导致出现故障。 时间密集型操作应由驱动程序作为单独的工作项排队，并在后台处理。 在此方案中，队列项与未来前/后调用所需的硬件更改之间的任何冲突都应由驱动程序管理。

要求

要求	值
目标平台	Windows
标头	d3dkmddi.h