IBasicVideo 接口 (control.h)

[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayer、 IMFMediaEngine 和 音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

接口 IBasicVideo 设置视频属性，例如目标和源矩形。 视频呈现器筛选器和视频混合呈现器筛选器实现此接口，但该接口通过 Filter Graph 管理器向应用程序公开。 应用程序应始终从 Filter Graph 管理器检索此接口。

接口 IBasicVideo 操作与视频图像关联的以下矩形：

• 源矩形是显示的原始图像的一部分。
• 目标矩形是接收源矩形的视频窗口部分。
• 视频矩形是原始视频图像。

换句话说，视频呈现器将图像裁剪到源矩形，然后将裁剪的图像拉伸或收缩到目标矩形。 所有矩形尺寸都以像素为单位提供。

在视频呈现器上设置的属性在连续连接和断开连接之间保留。

错误代码：如果视频呈现器筛选器未连接到另一个筛选器，则所有方法都会VFW_E_NOT_CONNECTED返回错误代码。 对于 Filter Graph Manager 的实现，如果图形不包含视频呈现器筛选器，则所有方法都会返回E_NOINTERFACE。 请注意，即使图形不包含视频呈现器，筛选器图形管理器也会公开接口，因此应用程序可以在生成图形之前查询接口。

继承

IBasicVideo 接口继承自 IDispatch 接口。 IBasicVideo 也有以下类型的成员：

方法

IBasicVideo 接口具有这些方法。

IBasicVideo：：get_AvgTimePerFrame get_AvgTimePerFrame 方法检索连续帧之间的平均时间。
IBasicVideo：：get_BitErrorRate get_BitErrorRate 方法检索视频流的近似位错误率。
IBasicVideo：：get_BitRate get_BitRate 方法检索视频流的近似比特率。
IBasicVideo：：get_DestinationHeight get_DestinationHeight 方法检索目标矩形的高度。
IBasicVideo：：get_DestinationLeft get_DestinationLeft 方法检索目标矩形的 x 坐标。
IBasicVideo：：get_DestinationTop get_DestinationTop 方法检索目标矩形的 y 坐标。
IBasicVideo：：get_DestinationWidth get_DestinationWidth 方法检索目标矩形的宽度。
IBasicVideo：：get_SourceHeight get_SourceHeight 方法检索源矩形的高度。
IBasicVideo：：get_SourceLeft get_SourceLeft 方法检索源矩形的 x 坐标。
IBasicVideo：：get_SourceTop get_SourceTop 方法检索源矩形的 y 坐标。
IBasicVideo：：get_SourceWidth get_SourceWidth 方法检索源矩形的宽度。
IBasicVideo：：get_VideoHeight get_VideoHeight 方法检索视频的本机高度。
IBasicVideo：：get_VideoWidth get_VideoWidth 方法检索视频的本机宽度。
IBasicVideo：：GetCurrentImage GetCurrentImage 方法检索在呈现器处等待的当前图像。
IBasicVideo：：GetDestinationPosition GetDestinationPosition 方法检索目标矩形的位置。
IBasicVideo：：GetSourcePosition GetSourcePosition 方法检索源矩形的位置。
IBasicVideo：：GetVideoPaletteEntries GetVideoPaletteEntries 方法检索视频的调色板颜色。
IBasicVideo：：GetVideoSize GetVideoSize 方法检索本机视频维度。
IBasicVideo：：IsUsingDefaultDestination IsUsingDefaultDestination 方法查询呈现器是否使用默认目标矩形。
IBasicVideo：：IsUsingDefaultSource IsUsingDefaultSource 方法查询呈现器是否使用默认源矩形。
IBasicVideo：:p ut_DestinationHeight put_DestinationHeight 方法设置目标矩形的高度。
IBasicVideo：:p ut_DestinationLeft put_DestinationLeft 方法设置目标矩形的 x 坐标。
IBasicVideo：:p ut_DestinationTop put_DestinationTop 方法设置目标矩形的 y 坐标。
IBasicVideo：:p ut_DestinationWidth put_DestinationWidth 方法设置目标矩形的宽度。
IBasicVideo：:p ut_SourceHeight put_SourceHeight 方法设置源矩形的高度。
IBasicVideo：:p ut_SourceLeft put_SourceLeft 方法设置源矩形的 x 坐标。
IBasicVideo：:p ut_SourceTop put_SourceTop 方法设置源矩形的 y 坐标。
IBasicVideo：:p ut_SourceWidth put_SourceWidth 方法设置源矩形的宽度。
IBasicVideo：：SetDefaultDestinationPosition SetDefaultDestinationPosition 方法将还原为默认目标矩形。 调用此方法后，视频呈现器将使用整个窗口进行播放。
IBasicVideo：：SetDefaultSourcePosition SetDefaultSourcePosition 方法将还原为默认源矩形。 调用此方法后，视频呈现器将使用整个视频图像，而无需裁剪。
IBasicVideo：：SetDestinationPosition SetDestinationPosition 方法设置目标矩形。
IBasicVideo：：SetSourcePosition SetSourcePosition 方法设置源矩形。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	control.h (包括 Dshow.h)

另请参阅

IDispatch