DirectShow API 基础知识概论

在写代码之前，我认为列出API的常用接口的方法和属性，是很有必要的。

FilgraphManager对象

这是一个最基本的控制器控制对象，看方法就知道了

属性	描述
FilterCollection	当前所有过滤器集合.
RegFilterCollection	注册表过滤器集合.

方法	Description
AddSourceFilter	加入一个源.
GetState	获取过滤器状态.
Pause	暂停.
RenderFile	创建过滤器图标.
Run	开始运行.
Stop	停止.
StopWhenReady	等待播放.

IBasicAudio接口

这个接口主要是用来处理音的.

属性	描述
Balance	设置或者获取音效平衡.
Volume	设置或者获取音量.

IVideoWindow接口

这个接口主要处理和窗口相关的控制器.

方法	描述
get_AutoShow	获取释放自动播放.
get_BackgroundPalette	Queries whether the video window realizes its palette in the background.
get_BorderColor	Retrieves the color that appears around the edges of the destination rectangle.
get_Caption	Retrieves the video window caption.
get_FullScreenMode	Queries whether the video renderer is in full-screen mode.
get_Height	Retrieves the height of the video window.
get_Left	Retrieves the video window's x-coordinate.
get_MessageDrain	Retrieves the window that receives mouse and keyboard messages from the video window, if any.
get_Owner	Retrieves the video window's parent window, if any.
get_Top	Retrieves the video window's y-coordinate.
get_Visible	Queries whether the video window is visible.
get_Width	Retrieves the width of the video window.
get_WindowState	Queries whether the video window is visible, hidden, minimized, or maximized.
get_WindowStyle	Retrieves the window style on the video window.
get_WindowStyleEx	Retrieves the extended window style on the video window.
GetMaxIdealImageSize	Retrieves the maximum ideal size for the video image.
GetMinIdealImageSize	Retrieves the minimum ideal size for the video image.
GetRestorePosition	Retrieves the restored window position.
GetWindowPosition	Retrieves the position of the video window.
HideCursor	Hides the cursor.
IsCursorHidden	Queries whether the cursor is hidden.
NotifyOwnerMessage	Forwards a message to the video window.
put_AutoShow	Specifies whether the video renderer automatically shows the video window when it receives video data.
put_BackgroundPalette	Specifies whether the video window realizes its palette in the background.
put_BorderColor	Sets the color that appears around the edges of the destination rectangle.
put_Caption	Sets the video window caption.
put_FullScreenMode	Enables or disables full-screen mode.
put_Height	Sets the height of the video window.
put_Left	Sets the video window's x-coordinate.
put_MessageDrain	Specifies a window to receive mouse and keyboard messages from the video window.
put_Owner	Specifies a parent window for the video window.
put_Top	Sets the video window's y-coordinate.
put_Visible	Shows or hides the video window.
put_Width	Sets the width of the video window.
put_WindowState	Shows, hides, minimizes, or maximizes the video window.
put_WindowStyle	Sets the window style on the video window.
put_WindowStyleEx	Sets the extended window style on the video window.
SetWindowForeground	Places the video window at the top of the Z order.
SetWindowPosition	Sets the position of the video window.

IMediaEvent 接口

此接口主要处理媒体事件.

方法	描述
CancelDefaultHandling	取消控制器对某事件的默认接口
FreeEventParams	释放事件资源
GetEvent	从事件列队获取下一事件.
GetEventHandle	从列队获取可用事件句柄.
RestoreDefaultHandling	保存控制器对某事件的接口为默认
WaitForCompletion	等待控制器处理数据.

IMediaEventEx接口

继承的是IMediaEvent 接口。

方法	描述
SetNotifyWindow	注册一个窗口到进程事件信息.
SetNotifyFlags	设置事件信息可用.
GetNotifyFlags	获取事件信息可用.

IMediaPosition 接口



这个接口主要处理播放流的的时间对应的位置信息.

Method	Description
get_Duration	Retrieves the duration of the stream.
put_CurrentPosition	Sets the current position, relative to the total duration of the stream.
get_CurrentPosition	Retrieves the current position, relative to the total duration of the stream.
get_StopTime	Retrieves the time at which the playback will stop, relative to the duration of the stream.
put_StopTime	Sets the time at which the playback will stop, relative to the duration of the stream.
get_PrerollTime	Retrieves the amount of data that will be queued before the start position.
put_PrerollTime	Sets the amount of data that will be queued before the start position.
put_Rate	Sets the playback rate.
get_Rate	Retrieves the playback rate.
CanSeekForward	Determines whether the filter graph can seek forward in the stream.
CanSeekBackward	Determines whether the filter graph can seek backward in the stream.