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 计划程序线程和延迟可能导致出现故障。 时间密集型作应按驱动程序排入队列，并在后台进行处理。 在此方案中，队列项与未来预/后调用所需的硬件更改之间的任何冲突都应由驱动程序管理。
要求
| 要求 | 价值 |
|---|---|
| 目标平台 | 窗户 |
| 标头 | d3dkmddi.h |