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 类型的结构，指定覆盖平面属性。

要求

要求	值
Header	d3dkmddi.h