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 。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | ksmedia.h (包含 Ksmedia.h) |