Windows----directshow----IBasicVideo接口

IBasicVideo接口（全解）

       这个接口支持通用的视频窗口的视频属性。一般情况下，视频渲染器将视频显示在显示器中的窗口上。IBasicVideo接口支持属性和方法，属性可以非常容易的从很多自动化控制器中存取，例如Microsoft ® Visual Basic ®编程系统。然而，一些操作需要很多属性一起变化。因为这层原因，它所提供的方法可以改变相关的属性。IBasicVideo接口的方法需要视频渲染器处于连接状态，如果没有处于连接状态，所有的接口方法返回VFW_E_NOT_CONNECTED。设置在视频渲染器上的属性处于保持连接和断开连接的状态。所有的应用程序需要确保在开始一个新的图像前重置渲染器的属性。当使用视频时，可发选取视频的一部分使用。这一部分是IBasicVideo接口控制的源矩形结构。IBasicVideo允许源矩形结构被设置和检索。IBasicVideo使用的所有矩形结构包括top属性、left属性、width属性、height属性而不是top属性、left属性、 right属性、 bottom属性，后面是在Win32编程中常用的。当没有设置源矩形结构时，源矩形结构的属性返回值为FULL，也就是本地视频的大小。     
什么时候执行     
视频渲染过滤器提供DirectShow执行这个接口。它也通过滤器图表筛选器执行，通过一个分销商插件，用于包含视频渲染过滤器接口的应用程序传递的方法。如果你正在写一个视频渲染过滤器的代替者或者DirectShow分销商的插件。你可以使用CBaseBasicVideo类，它可以对IDispath实现自动化，并且可以帮助实现这个接口。
什么时候使用
当过滤器图表管理器公开这个接口时，使用它的应用程序必须控制视频渲染过滤器的属性。
虚函数表订单中的方法
在下表中显示的方法出现在虚表的标准COM下从IUnKnown继承的方法。

Idispatch方法

描述

GetTypeInfoCount

确定调度节口是否有可用的类型信息

GetTypeInfo

如果GetTypeInfoCount返回成功，则为此调度节口检索类型信息

GetIDsOfNames

将属性、方法包括论述转换为和DISPIDs相适应的文本名

Invoke

如果得到一个DISPID和任何其它必要的参数，那么在此调度节口调用一个方法或者访问一个属性

IbasicVideo方法

描述

Get_AvgTimePerFrame

检索在连续的结构中100纳秒每单元所需要的平均时间

Get_BitRate

检索视频流中近似的比特率

Get_BitErrorRate

检索视频流中近似的误码率

Get_VideoWidth

检索当前视频的宽度

Get_VideoHeight

检索当前视频的高度

Put_SourceLeft

设置源视频矩形结构的X坐标

Get_SourceLeft

检索源视频矩形结构的X坐标

Put_SourceWidth

设置源视频矩形的宽度

Get_SourceWidth

检索源视频窗口的宽度

Put_SourceTop

设置源视频矩形结构的Y坐标

Get_SourceTop

检索源视频矩形结构的Y坐标

Put_SourceHeight

设置源视频矩形结构的高度

Get_SourceHeight

检索源视频矩形结构的高度

Put_DestinationLeft

设置目标视频矩形结构的X坐标

Get_DestinationLeft

检索目标视频矩形结构的X坐标

Put_DestinationWidth

设置目标视频矩形结构的宽度

Get_DestinationWidth

检索目标视频矩形结构的宽度

Put_DestinationTop

设置目标视频矩形结构的Y坐标

Get_DestinationTop

检索目标视频矩形结构的Y坐标

Put_DestinationHeight

设置目标视频矩形结构的高度

Get_DestinationHeight

检索目标视频矩形结构的高度

SetSourcePosition

设置源视频矩形结构

GetSourcePosition

检索源视频矩形结构

SetDefaultSourcePosition

通知渲染器使用默认的源矩形结构

SetDestinationPosition

为窗体设置目标矩形结构

GetDestinationPosition

为窗体检索目标视频矩形结构

SetDefaultDestinationPosition

为窗体设置默认的目标位置

GetVideoSize

检索本地视频的规格

GetVideoPaletteEntries

检索视频调色板的入口

GetCurrentImage

返回在渲染器中等待的当前图片的副本

IsUsingDefaultSource

确定渲染器是否使用默认的源矩形结构

IsUsingDefaultDestination

确定渲染器是否使用默认的目标矩形结构