ksmedia.h) (KS_VBI_FRAME_INFO 结构

  • 项目

KS_VBI_FRAME_INFO 结构扩展了垂直空白间隔的 KSSTREAM_HEADER 结构， (VBI) 流。

语法

typedef struct tagKS_VBI_FRAME_INFO {
  ULONG                  ExtendedHeaderSize;
  DWORD                  dwFrameFlags;
  LONGLONG               PictureNumber;
  LONGLONG               DropCount;
  DWORD                  dwSamplingFrequency;
  KS_TVTUNER_CHANGE_INFO TvTunerChangeInfo;
  KS_VBIINFOHEADER       VBIInfoHeader;
} KS_VBI_FRAME_INFO, *PKS_VBI_FRAME_INFO;

成员

ExtendedHeaderSize

指定此结构的大小。

dwFrameFlags

指定指示有关捕获的帧的其他信息的标志。 在捕获期间，微型驱动程序将此成员设置为 ksmedia.h 中定义的以下值之一：

标志 含义
KS_VBI_FLAG_FIELD1 指示双字段序列的第一个字段
KS_VBI_FLAG_FIELD2 指示双字段序列的第二个字段
KS_VBI_FLAG_MV_PRESENT 指示宏视觉保护方案
KS_VBI_FLAG_MV_HARDWARE 指示宏视觉硬件支持
KS_VBI_FLAG_MV_DETECTED 指示检测到宏视觉
KS_VBI_FLAG_TVTUNER_CHANGE 指示 TvTunerChangeInfo 成员结构包含有效数据
KS_VBI_FLAG_VBIINFOHEADER_CHANGE 指示 VBIInfoHeader 成员结构包含有效数据

PictureNumber

指定表示当前图片编号的计数。 在转换为 KSSTATE_ACQUIRE 时初始化或更新此值。

DropCount

指定未捕获的图片数。 捕获视频时，微型驱动程序会设置此成员。 每当应捕获帧但未捕获帧时，应递增此计数器;当捕获期间没有可用的缓冲区时，通常会出现这种情况。 在转换为 KSSTATE_ACQUIRE 时初始化或更新此值。

dwSamplingFrequency

指定采样频率（以hz (Hz) 为单位）。

TvTunerChangeInfo

指定有关当前 VBI 数据源的信息，包括国家/地区代码、模拟视频标准和频道。 仅当 dwFrameFlags 指定KS_VBI_FLAG_TVTUNER_CHANGE标志时，此成员才有效。

VBIInfoHeader

指定有关当前 VBI 数据源的信息，包括起始行、终点线、采样频率和视频标准。 仅当 dwFrameFlags 指定KS_VBI_FLAG_VBIINFOHEADER_CHANGE标志时，此成员才有效。

注解

KS_VBI_FRAME_INFO 结构提供了一种返回有关捕获帧的信息以及向 VBI 解码器提供优化信息的方法。

PictureNumber 成员计数基于用于打开流的格式表示当前图片的计数。 此计数按以下两种方式之一计算，具体取决于设备：

  1. 测量流启动后的时间，并除以帧持续时间。 此方法适用于不提供自己的时钟的设备。 例如： PictureNumber = (CurrentStreamTime • StartStreamTime) / FrameDuration

  2. 将捕获的帧计数和丢弃的帧计数相加。 此方法适用于提供其自己的时钟的设备。 例如： PictureNumber = FramesCaptured + FramesDropped

在计算 PictureNumber 和 DropCount 时，请务必使用打开流时指定的帧持续时间，这可能不一定与设备实际生成图像的速率相匹配。 例如，USB 相机只能以 7.5 fps 的速度生成图像，但客户端可以以 8 fps 的速度打开流。 在这种情况下，所有计算都应使用 8 fps 数字。 有关更新 PictureNumber 和 DropCount 的详细信息，请参阅 捕获视频。

dwSamplingFrequency 成员不由 Microsoft VBI 编解码器使用，但可由其他 WDM 编解码器使用。 它必须与 VBIInfoHeader 相同。SamplingFrequency 成员。 微型驱动程序通过在 dwFrameFlags 成员中设置KS_VBI_FLAG_VBIINFOHEADER_CHANGE位，并在 VBIInfoHeader 结构中填充所有成员（包括 dwSamplingFrequency）来指示采样频率的变化。

要求

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

另请参阅

KSSTREAM_HEADER

KS_TVTUNER_CHANGE_INFO

KS_VBIINFOHEADER