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

表示するオーバーレイ 平面の 0 から始まるインデックス。 上平面 (z 方向) には、インデックス 0 が付けられます。 平面のインデックス値は、上から下に順番に指定する必要があります。

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 to TRUE。

ContextCount

Context メンバーが指定する配列内のコンテキストの数。

ppContextData

表示操作に貢献したコンテキストへのハンドルの配列。

DriverPrivateDataSize

プライベート ドライバー データのサイズ。

pDriverPrivateData

プライベート ドライバー データ。

PlaneAttributes

オーバーレイ プレーン属性を指定する DXGK_MULTIPLANE_OVERLAY_ATTRIBUTES3 型の構造体。

要件