KS_VIDEOINFO 結構 (ksmedia.h)

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

語法

typedef struct tagKS_VIDEOINFO {
  RECT                rcSource;
  RECT                rcTarget;
  DWORD               dwBitRate;
  DWORD               dwBitErrorRate;
  REFERENCE_TIME      AvgTimePerFrame;
  KS_BITMAPINFOHEADER bmiHeader;
  union {
    KS_RGBQUAD       bmiColors[KS_iPALETTE_COLORS];
    DWORD            dwBitMasks[KS_iMASK_COLORS];
    KS_TRUECOLORINFO TrueColorInfo;
  };
} KS_VIDEOINFO, *PKS_VIDEOINFO;

成員

rcSource

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

rcTarget

指定矩形，指出要使用的目標緩衝區哪個部分。

dwBitRate

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

dwBitErrorRate

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

AvgTimePerFrame

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

bmiHeader

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

bmiColors[KS_iPALETTE_COLORS]

指定影片調色盤之KS_RGBQUAD結構的陣列。 每個結構都代表單一色彩，這是紅色、綠色和藍色濃度的組合。

dwBitMasks[KS_iMASK_COLORS]

指定 true-color 位掩碼的 DWORD 值陣列。

TrueColorInfo

KS_TRUECOLORINFO 結構，其中包含調色盤和色彩位掩碼數位數組。

備註

除非KS_BITMAPINFOHEADER成員的 biSize 成員設定為 sizeof (KS_BITMAPINFOHEADER) ，否則不得使用此結構。

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

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

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

規格需求

另請參閱

KS_BITMAPINFOHEADER

KS_RGBQUAD

KS_TRUECOLORINFO