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]
指定真色位掩码的 DWORD 值的数组。
TrueColorInfo
KS_TRUECOLORINFO 结构，其中包含调色板和颜色位掩码数组。
注解
除非将 KS_BITMAPINFOHEADER 成员的 biSize 成员设置为 sizeof (KS_BITMAPINFOHEADER) ，否则不得使用此结构。
源筛选器可以通过提供在 rcSource 成员中有效定义剪裁矩形的值，请求接收器筛选器仅获取视频的一部分。 但是，如果接收器筛选器未在连接时为剪裁矩形检查，接收器筛选器只会呈现所有视频，从而有效地忽略从源筛选器传递到接收器筛选器的任何剪辑信息。
理想情况下，接收器筛选器会检查 rcSource ，如果接收器筛选器不支持图像提取且矩形 不 为空，则拒绝连接。 筛选器应使用 Win32 函数 SetRectEmpty 将矩形重置为 (的所有零，并使用 IsRectEmpty 在以后检查矩形) 。
rcTarget 成员指定视频的目标矩形。 大多数源筛选器将此成员设置为所有零。 下游筛选器可以请求将视频放置在它提供的缓冲区的特定区域中。 在本例中，它调用具有非空目标的 Win32 函数 QueryAccept 。
要求
| 要求 | 值 |
|---|---|
| Header | ksmedia.h (包括 Ksmedia.h) |