D3DDDIARG_VIDEOPROCESSBLT 構造体 (d3dumddi.h)

[アーティクル]
02/23/2024

D3DDDIARG_VIDEOPROCESSBLT構造では、実行する Microsoft DirectX ビデオアクセラレーション (VA) ビデオ処理操作について説明します。

構文

typedef struct _D3DDDIARG_VIDEOPROCESSBLT {
  [in] REFERENCE_TIME               TargetFrame;
  [in] HANDLE                       hVideoProcess;
  [in] RECT                         TargetRect;
  [in] SIZE                         ConstrictionSize;
  [in] UINT                         StreamingFlags;
  [in] DXVADDI_AYUVSAMPLE16         BackgroundColor;
  [in] DXVADDI_EXTENDEDFORMAT       DestFormat;
  [in] DXVADDI_VIDEOPROCESSBLTFLAGS DestFlags;
  [in] DXVADDI_PROCAMPVALUES        ProcAmpValues;
  [in] DXVADDI_FIXED32              Alpha;
  [in] DXVADDI_FILTERVALUES         NoiseFilterLuma;
  [in] DXVADDI_FILTERVALUES         NoiseFilterChroma;
  [in] DXVADDI_FILTERVALUES         DetailFilterLuma;
  [in] DXVADDI_FILTERVALUES         DetailFilterChroma;
  [in] DXVADDI_VIDEOSAMPLE          *pSrcSurfaces;
  [in] UINT                         NumSrcSurfaces;
} D3DDDIARG_VIDEOPROCESSBLT;

メンバー

[in] TargetFrame

入力フレームのシーケンス内の出力フレームの位置を識別するREFERENCE_TIME値。インターレース解除のみが実行される場合、ターゲット時刻は、DXVADDI_VIDEOSAMPLE構造体の Start メンバーによって定義されるサンプルの開始表示時間、または開始表示時間と終了表示時間の中間点のいずれかと一致する必要があります。

フレームレート変換が要求された場合、 TargetFrame の時間は、サンプルの Start メンバーの時刻と異なる場合があります。

[in] hVideoProcess

DirectX VA ビデオ処理デバイスへのハンドル。ユーザーモードの表示ドライバーは、 CreateVideoProcessDevice 関数の呼び出しでこのハンドルを返します。

[in] TargetRect

出力イメージの書き込み先となるサーフェス内の位置を表す RECT 構造体へのポインター。出力イメージは、 TargetRect によって指される四角形内のピクセルに制限されることに注意してください。つまり、この四角形内のすべてのピクセルをに書き込む必要があります。この四角形の外側のピクセルは変更しないでください。

[in] ConstrictionSize

保護されたコンテンツに対して、出力イメージを縮小するサイズを指定する SIZE 構造体。 ConstrictionSize は、 TargetRect メンバーで指定されたターゲット四角形の (1, 1) から (幅、高さ) までである必要があります。 ConstrictionSize は、constriction を表すには (0, 0) にする必要があります。

たとえば、ネイティブに 1920 x 1080 ピクセルで、出力保護がサポートされていない 1920 x 1080 解像度のモニターに全画面表示されるビデオを考えてみましょう。ビデオコンテンツで、元の情報の 854 x 480 ピクセルのみを表示できるルールが指定されている場合、ドライバーは元の画像を 1920 x 1080 から 854 x 480 に減らし、イメージをもう一度 1920 x 1080 に拡大する必要があります。この例では、 ConstrictionSize メンバーの SIZE 構造体で、854 x 480 ピクセルのサイズを指定します。

[in] StreamingFlags

ストリーミングフラグを識別する UINT 値。現在、ストリーミングフラグは定義されていません。

[in] BackgroundColor

背景色を識別する DXVADDI_AYUVSAMPLE16 構造体。

[in] DestFormat

変換先サーフェスの拡張形式情報を識別する DXVADDI_EXTENDEDFORMAT 構造体。

[in] DestFlags

前の変換先サーフェスからの現在の変換先サーフェスの変更を識別するDXVADDI_VIDEOPROCESSBLTFLAGS構造体。

[in] ProcAmpValues

変換先サーフェスに出力される ProcAmp 調整データを指定する DXVADDI_PROCAMPVALUES 構造体。

[in] Alpha

出力イメージが宛先サーフェスに書き込まれるときの平面透過性の値を指定する DXVADDI_FIXED32 構造体。アルファ値が 1.0 の場合、背景色は不透明 (透明度とアルファブレンドなし) で描画されます。アルファ値が 0.0 の場合、背景は描画されません (透明)。

[in] NoiseFilterLuma

luma ノイズフィルターを指定する DXVADDI_FILTERVALUES 構造体。

[in] NoiseFilterChroma

クロマノイズフィルターを指定する DXVADDI_FILTERVALUES 構造。

[in] DetailFilterLuma

luma 詳細フィルターを指定する DXVADDI_FILTERVALUES 構造体。

[in] DetailFilterChroma

クロマ詳細フィルターを指定する DXVADDI_FILTERVALUES 構造体。

[in] pSrcSurfaces

インターレース解除、フレームレート変換、サブストリーム合成操作に必要な入力サンプルを記述するDXVADDI_VIDEOSAMPLE構造体の配列。この配列に入力サンプルを配置する方法の詳細については、「入力バッファーの順序」を参照してください。

[in] NumSrcSurfaces

pSrcSurfaces にある配列内の入力サンプルの数。

要件

要件	値
サポートされている最小のクライアント	Windows Vista 以降のバージョンの Windows オペレーティングシステムで使用できます。
Header	d3dumddi.h (D3dumddi.h を含む)