DXGI_DDI_MULTIPLANE_OVERLAY_ATTRIBUTES 構造体 (dxgiddi.h)

[アーティクル]
08/07/2023

オーバーレイプレーン属性を指定するためにユーザーモードディスプレイドライバーによって使用されます。

構文

typedef struct DXGI_DDI_MULTIPLANE_OVERLAY_ATTRIBUTES {
  UINT                                           Flags;
  RECT                                           SrcRect;
  RECT                                           DstRect;
  RECT                                           ClipRect;
  DXGI_DDI_MODE_ROTATION                         Rotation;
  DXGI_DDI_MULTIPLANE_OVERLAY_BLEND              Blend;
  UINT                                           DirtyRectCount;
  RECT                                           *pDirtyRects;
  UINT                                           NumFilters;
  void                                           *pFilters;
  DXGI_DDI_MULTIPLANE_OVERLAY_VIDEO_FRAME_FORMAT VideoFrameFormat;
  UINT                                           YCbCrFlags;
  DXGI_DDI_MULTIPLANE_OVERLAY_STEREO_FORMAT      StereoFormat;
  BOOL                                           StereoLeftViewFrame0;
  BOOL                                           StereoBaseViewFrame0;
  DXGI_DDI_MULTIPLANE_OVERLAY_STEREO_FLIP_MODE   StereoFlipMode;
  DXGI_DDI_MULTIPLANE_OVERLAY_STRETCH_QUALITY    StretchQuality;
} DXGI_DDI_MULTIPLANE_OVERLAY_ATTRIBUTES;

メンバー

Flags

反転操作を、 DXGI_DDI_MULTIPLANE_OVERLAY_FLAGS 列挙の適用可能な値の 1 つとして指定します。

SrcRect

ソースリソースを基準にして、 RECT 型のソース四角形を指定します。

DstRect

モニターの解像度に対する RECT 型の変換先の四角形を指定します。

ClipRect

SrcRect と DstRect の値に従ってデータを拡大した後、DstRect 四角形に対して RECT 型の追加クリッピングを指定します。

ドライバーとハードウェアは 、ClipRect メンバーを使用して、アプリが DstRect 変換先の四角形の一部を隠したときにクリッピングが変化したときに共通のストレッチファクターを適用できます。

Rotation

DXGI_DDI_MODE_ROTATION列挙体の値として指定されたオーバーレイ平面の時計回りの回転を指定します。

Blend

このオーバーレイ平面とその下の平面に適用されるブレンドモードを、 DXGI_DDI_MULTIPLANE_OVERLAY_BLEND 列挙体の値として指定します。

DirtyRectCount

オーバーレイ平面に指定ダーティ四角形の数。 0 の場合、平面全体がダーティと見なされます。

pDirtyRects

変更されたオーバーレイ平面の部分を示す、ソース四角形 SrcRect に対する相対ダーティ四角形 (RECT) の配列へのポインター。

ドライバーは、このメンバーを使用して最適化を実行できますが、ダーティ四角形の情報を使用する必要はありません。ただし、ドライバーは、指定されたダーティ四角形に基づいて関数呼び出しを失敗させるべきではありません。

NumFilters

必要に応じて、ドライバーとハードウェアがオーバーレイプレーンに実装するフィルターの数を指定します。オペレーティングシステムはこのメンバーを無視します。

pFilters

ドライバーとハードウェアがオーバーレイプレーンに実装するフィルターを指定するバッファーへの省略可能なポインター。オペレーティングシステムはこのメンバーを無視します。

VideoFrameFormat

DXGI_DDI_MULTIPLANE_OVERLAY_VIDEO_FRAME_FORMAT列挙体の値として指定された、オーバーレイプレーンのビデオフレーム形式を指定します。

メモこの値は常に DXGI_DDI_MULIIPLANE_OVERLAY_VIDEO_FRAME_FORMAT_PROGRESSIVEする必要があります。オペレーティングシステムは、他の列挙値をサポートしていません。

YCbCrFlags

YUV 範囲と変換情報を、DXGI_DDI_MULTIPLANE_OVERLAY_YCbCr_FLAGS 列挙の適用可能な値の 1 つとして指定します。

StereoFormat

DXGI_DDI_MULTIPLANE_OVERLAY_STEREO_FORMAT列挙体の値として指定された、オーバーレイプレーンのビデオフレーム形式を指定します。

メモこの値は常に DXGI_DDI_MULTIPLANE_OVERLAY_STEREO_FORMAT_MONOする必要があります。オペレーティングシステムは、他の列挙値をサポートしていません。

StereoLeftViewFrame0

システムで使用するために予約されています。常に FALSE にする必要があります。

StereoBaseViewFrame0

システムで使用するために予約されています。常に FALSE にする必要があります。

StereoFlipMode

DXGI_DDI_MULTIPLANE_OVERLAY_STEREO_FLIP_MODE列挙体の値として指定されたオーバーレイプレーンのステレオフリップモードを指定します。

メモこの値は常に DXGI_DDI_MULTIPLANE_OVERLAY_STEREO_FLIP_NONEする必要があります。オペレーティングシステムは、他の列挙値をサポートしていません。

StretchQuality

DXGI_DDI_MULTIPLANE_OVERLAY_STRETCH_QUALITY 列挙体の値として指定されたオーバーレイプレーンのストレッチ品質を指定します。

要件

要件	値
サポートされている最小のクライアント	Windows 8.1
サポートされている最小のサーバー	Windows Server 2012 R2
Header	dxgiddi.h (D3d10umddi.h を含む)