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 |