DXGK_MULTIPLANE_OVERLAY_PLANE3结构（d3dkmddi.h）

指定要在调用 DxgkDdiSetVidPnSourceAddressWithMultiPlaneOverlay3 函数时显示的覆盖平面。

语法

typedef struct _DXGK_MULTIPLANE_OVERLAY_PLANE3 {
  UINT                                LayerIndex;
  ULONGLONG                           PresentId;
  DXGK_PLANE_SPECIFIC_INPUT_FLAGS     InputFlags;
  DXGK_PLANE_SPECIFIC_OUTPUT_FLAGS    OutputFlags;
  UINT                                MaxImmediateFlipLine;
  UINT                                ContextCount;
  DXGK_PRIMARYCONTEXTDATA             **ppContextData;
  UINT                                DriverPrivateDataSize;
  PVOID                               pDriverPrivateData;
  DXGK_MULTIPLANE_OVERLAY_ATTRIBUTES3 PlaneAttributes;
} DXGK_MULTIPLANE_OVERLAY_PLANE3;

成员

LayerIndex

要显示的覆盖平面的从零开始的索引。 顶部平面（在 z 方向）具有索引零。 平面的索引值必须是从上到下的顺序。

PresentId

驱动程序用于报告覆盖命令完成情况的 64 位每平面标识符。

InputFlags

一个 DXGK_PLANE_SPECIFIC_INPUT_FLAGS 结构，用于标识要执行的任何平面特定的显示作。

OutputFlags

包含驱动程序返回的状态的 DXGK_PLANE_SPECIFIC_OUTPUT_FLAGS 结构。

MaxImmediateFlipLine

显示行描述是否应将 VSYNC 翻转提升为即时翻转，其中第 0 行对应于帧的第一个活动像素。 对于非 VSYNC 翻转，将忽略此值。

当不需要从 VSYNC 翻转升级到即时翻转时，此值 -1。 在这种情况下，翻转将始终等待下一个 VSYNC。

对于 -1 以外的值，如果 HW 尚未从指定的显示行开始读取，驱动程序应将此翻转提升为即时翻转。 如果 HW 已锁定当前显示帧的寄存器，但尚未开始扫描第一个活动像素，则可以将 0 的值提升为即时翻转。

显示行值相对于设置的物理模式。 如果显示正在执行缩放，则显示行相对于应用缩放后的大小。

将 VSYNC 翻转提升为即时翻转时，驱动程序应设置 DXGK_PLANE_SPECIFIC_OUTPUT_FLAGS。 FlipConvertedToImmediate 到 TRUE。

ContextCount

上下文成员指定的数组中的上下文数。

ppContextData

为显示作做出贡献的上下文的句柄数组。

DriverPrivateDataSize

专用驱动程序数据的大小。

pDriverPrivateData

专用驱动程序数据。

PlaneAttributes

DXGK_MULTIPLANE_OVERLAY_ATTRIBUTES3 类型的结构，用于指定覆盖平面属性。

要求

要求	价值
标头	d3dkmddi.h