DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3回调函数 (d3dkmddi.h)

  • 项目

调用 DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 来更改显示的覆盖配置。

语法

DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 DxgkddiSetvidpnsourceaddresswithmultiplaneoverlay3;

NTSTATUS DxgkddiSetvidpnsourceaddresswithmultiplaneoverlay3(
  IN_CONST_HANDLE hAdapter,
  IN_OUT_PDXGKARG_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 pSetVidPnSourceAddressWithMultiPlaneOverlay
)
{...}

参数

hAdapter

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

pSetVidPnSourceAddressWithMultiPlaneOverlay

指向 DXGKARG_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 结构的指针，该结构描述要呈现的图面和显示选项。

返回值

DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 返回以下值：

返回代码 说明
STATUS_SUCCESS 例程已成功完成。
STATUS_INVALID_PARAMETER 在 [硬件翻转队列模型]/windows-hardware/drivers/display/hardware-flip-queue) 中，驱动程序无法处理翻转请求。
STATUS_RETRY 由于驱动程序由于挂起的翻转或需要在PASSIVE_LEVEL调用驱动程序等原因而无法对 硬件的请求排队 等原因而返回。 如果需要在PASSIVE_LEVEL调用驱动程序，则还应设置 DXGK_SETVIDPNSOURCEADDRESS_OUTPUT_FLAGS。PrePresentNeeded 标志。

注解

此函数通常在中断级别调用，但如果驱动程序需要执行只能在PASSIVE_LEVEL执行的硬件配置，驱动程序可以通过返回STATUS_RETRY并设置DXGK_SETVIDPNSOURCEADDRESS_OUTPUT_FLAGS，请求在PASSIVE_LEVEL召回此函数。PrePresentNeeded 标志。

即使在PASSIVE_LEVEL调用时，驱动程序也应避免在此调用中花费大量时间，因为调用会阻止 GPU 计划程序线程main，延迟可能会导致出现故障。 时间密集型操作应由驱动程序作为单独的工作项排队，并在后台处理。 在此方案中，应由驱动程序管理排队项和将来的预/后调用所需的硬件更改之间的任何冲突。

要求

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

另请参阅

DXGKARG_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3