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

要求

要求
Header ksmedia.h (包括 Ksmedia.h)

另请参阅

KS_BITMAPINFOHEADER

KS_VIDEOINFOHEADER2