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) |