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 應從 (1、1) 到 (寬度、高度) 在 TargetRect 成員中指定的目標矩形。 ConstrictionSize 應該 (0,0) 表示無限制。

例如，假設原本有 1920 x 1080 像素的視訊，且在不支持輸出保護的 1920 x 1080 解析度監視器上顯示全螢幕。如果視訊內容指定只能顯示 854 x 480 像素的原始資訊的規則，驅動程式必須將原始影像從 1920 x 1080 縮減為 854 x 480，然後將影像再次延展至 1920 x 1080。在此範例中， ConstrictionSize 成員中的SIZE結構會指定854 x480像素的大小。

[in] StreamingFlags

識別串流旗標的UINT值。目前未定義任何串流旗標。

[in] BackgroundColor

識別背景色彩的DXVADDI_AYUVSAMPLE16 結構。

[in] DestFormat

識別目的地介面擴充格式資訊的 DXVADDI_EXTENDEDFORMAT 結構。

[in] DestFlags

DXVADDI_VIDEOPROCESSBLTFLAGS 結構，可識別上一個目的地介面中目前目的地介面中的變更。

[in] ProcAmpValues

DXVADDI_PROCAMPVALUES 結構，指定輸出至目的地介面的 ProcAmp 調整數據。

[in] Alpha

DXVADDI_FIXED32 結構，指定將輸出影像寫入目的地表面時，輸出影像的平面透明度值。當Alpha值為1.0時，背景色彩會不透明繪製 (，而沒有透明度和Alpha混合) 。當Alpha值為0.0時，背景不應繪製 (透明) 。