KS_VIDEOINFOHEADER 結構 (ksmedia.h)

KS_VIDEOINFOHEADER 結構描述視訊數據流的點陣圖和色彩資訊。

語法

typedef struct tagKS_VIDEOINFOHEADER {
  RECT                rcSource;
  RECT                rcTarget;
  DWORD               dwBitRate;
  DWORD               dwBitErrorRate;
  REFERENCE_TIME      AvgTimePerFrame;
  KS_BITMAPINFOHEADER bmiHeader;
} KS_VIDEOINFOHEADER, *PKS_VIDEOINFOHEADER;

成員

rcSource

指定要使用中視訊訊號部分的裁剪矩形。

rcTarget

指定定義目標目的地視訊視窗的矩形。

dwBitRate

指定值，指出視訊數據流的近似數據速率，以每秒的位為單位。

dwBitErrorRate

指定值，指出視訊數據流的數據錯誤率，以每秒位錯誤為單位。

AvgTimePerFrame

指定每個畫面的平均時間，以100奈秒為單位。

bmiHeader

描述包含視訊影像位圖之色彩和維度資訊的 KS_BITMAPINFOHEADER 結構。

備註

若要描述具有 bob 或 weave 設定的視訊串流，請使用 KS_VIDEOINFOHEADER2。

KS_VIDEOINFOHEADER 結構與 Microsoft DirectShow VIDEOINFOHEADER 結構相同。

來源篩選條件可以藉由提供有效定義 rcSource 成員中裁剪矩形的值，要求接收篩選只接受視訊的區段。 不過，如果接收篩選未檢查連接上的裁剪矩形，接收篩選只會轉譯所有視訊，有效地忽略從來源篩選傳遞至接收篩選的任何裁剪資訊。

在理想情況下，接收篩選會檢查 rcSource ，如果接收篩選不支援影像擷取，而且矩形 不是 空的，則會拒絕連線。 篩選條件應該使用 Win32 函式 SetRectEmpty 將矩形重設為所有零 (，並將 IsRectEmpty 設定為稍後檢查矩形) 。

rcTarget 成員會指定影片的目的地矩形。 大部分的來源篩選會將這個成員設定為所有零。 下游篩選條件可以要求影片放在它所提供的緩衝區的特定區域中。 在此情況下，它會使用無空目標呼叫 Win32 函式 QueryAccept 。

規格需求

另請參閱

KS_BITMAPINFOHEADER

KS_VIDEOINFOHEADER2