在正确安装好DirectX SDK后,我们必须设置DirectX SDK的头文件和库文件,使其在Visual Studio的搜索路径内。
对于Visual Studio .NET 2003可如下进行设置:菜单→工具→选项→项目→VC++目录,在包含文件中加入D:\DXSDK\Include,在库文件中加入D:\DXSDK\lib(我的SDK的安装路径是D:\DXSDK):头文件文件名称描述Dshow.h所有的DirectShow应用都必须包含库文件文件名称描述Strmiids.lib此库文件中导出类标识(CLSID)和接口标识(IID),所有的DirectShow应用都必须包含此文件。
Quartz.lib此库文件中导出函数AMGetErrorText,如果你的程序中调用了此函数,则必须包含此库文件。
DirectShow之接口实战篇(一)现今自己编程做一个多媒体播放工具是一件很令人开心愉悦的事情,但如果使用MediaPlay 控件开发则会受到很多限制,自己的很多好的创意想法都无法或者很难实现,如果利用微软的DirectX接口开发则可以充分的将作者的独特想法付诸于实现,何乐而不为呢!!不过关于DirectShow接口的开发说明文档实在是少之又少,仅有的一些不是英文的就是一些关于理论方面的,真正关于接口实战编程而且是用Delphi开发工具实现的更是凤毛麟角,使很多人都望而却步。
在这里,我把我应用Directshow开发的心得以及我搜集到一些资料重新整理编辑出来公布,希望对所有由此兴趣的同仁有所帮助,就算达到了我的目的。
废话少说,进入正文。
既然是接口实战篇,就先把一些常用的接口列出来,让大家有一些基本的认识,都是用来做什么的,什么时候我们会需要用到此接口。
IFilterGraph 过滤通道接口IFilterGraph2 增强的IFilterGraphIGraphBuilder 最为重用的COM接口,用于手动或者自动构造过滤通道Filter Graph ManagerIMediaControl 用来控制流媒体,例如流的启动和停止暂停等,播放控制接口IMediaEvent 播放事件接口,该接口在Filter Graph发生一些事件时用来创建事件的标志信息并传送给应用程序IMediaEventEx 扩展播放事件接口IMediaPosition 播放的位置和速度控制接口(控制播放位置只能为设置时间控制方式)IMediaSeeking 另一个播放的位置和播放速度控制接口,在位置选择方面功能较强.设置播放格式,多种控制播放方式.常用的有:(1)TIME_FORMAT_MEDIA_TIME单位100纳秒。
(2)TIME_FORMAT_FRAME按帧播放IBasicAudio 声音控制接口IBasicVideo 图像控制接口(波特率,宽度,长度等信息)IVideoWindow 显示窗口控制接口(有关播放窗口的一切控制,包括caption显示,窗口位置控制等)ISampleGrabber 捕获图象接口(可用于抓图控制)IVideoFrameStep 控制单帧播放的接口好了,熟悉了应用DirectShow应用开发常用的接口后,我们就通过一个实例媒体播放器来熟悉掌握这些接口,实例的代码虽然简单,但五脏俱全,功能强大,同时也了解一下应用DirectShow开发一般常用的步骤。
附2:EC_ACTIVATE 视频窗口被激活或者转为非激活状态EC_BUFFERING_DATA 过滤图形包含缓冲数据EC_CLOCK_CHANGED 参考时钟被改变EC_CLOCK_UNSET 时钟提供者被断开EC_COMPLETE 所有数据被渲染完毕EC_DEVICE_LOST 一个即插即用设备被移除或者变为有效.EC_DISPLAY_CHANGED 显示模式被改变EC_END_OF_SEGMENT 到达段的末尾.EC_ERROR_STILLPLAYING 一个异步命令失败EC_ERRORABORT 一个操作被放弃EC_EXTDEVICE_MODE_CHANGE 不支持EC_FULLSCREEN_LOST 一个视频渲染窗口被切换出全屏模式.EC_GRAPH_CHANGED 过滤器图被改变EC_LENGTH_CHANGED 源的长度被改变.EC_NEED_RESTART 过滤器请求过滤图重新开始.EC_NOTIFY_WINDOW 通报一个视频渲染窗口的过滤器EC_OLE_EVENT 过滤器传递一个字符串给应用程序。
.EC_OPENING_FILE 过滤图打开一个文件,或者已经完成了打开文件操作EC_PALETTE_CHANGED 视频调色板被改变.EC_PAUSED 一个暂停请求被处理.EC_QUALITY_CHANGE 过滤图为了质量控制丢桢EC_REPAINT 一个视频渲染器要求重绘.EC_SEGMENT_STARTED 一个新段开始EC_SHUTTING_DOWN 过滤器图被关闭EC_SNDDEV_IN_ERROR 一个音频设备的输入引脚错误.EC_SNDDEV_OUT_ERROR 一个音频设备的输出引脚错误.EC_STARVATION 过滤器没有得到足够的数据.EC_STATE_CHANGE 过滤器图状态改变EC_STEP_COMPLETE 一个过滤器执行了单桢渐进EC_STREAM_CONTROL_STARTED 流控制开始命令产生效果.EC_STREAM_CONTROL_STOPPED 一个流控制的停止命令产生效果EC_STREAM_ERROR_STILLPLAYING 在流中产生了一个错误,但流还是在运行中.EC_STREAM_ERROR_STOPPED 一个流因错误而停止EC_TIMECODE_AVAILABLE 不支持EC_USERABORT 用户中断回放.EC_VIDEO_SIZE_CHANGED 本地视频尺寸改变.EC_WINDOW_DESTROYED 视频渲染器被销毁,或者从过滤器图中移除.DirectShow之接口实战篇(二)大体说来,一般使用DirectShow接口编程无非3个步骤,初始化接口,利用接口中的控制函数使用控制操作,最后释放接口。
(当然这里假定你已经拥有了directshow.pas等必须单元,如果没有的话请在网上查找或者向我索要)(注:以下变量没有定义,需自己定义使用)1)初始化接口部分首先,需要定义需要使用的接口变量GraphBuilder: IGraphBuilder;MediaControl: IMediaControl;MediaSeeking: IMediaSeeking;MediaPosition: IMediaPosition;MediaEventEx: IMediaEvent;BasicAudio: IBasicAudio;BasicVideo: IBasicVideo;VideoWindow: IVideoWindow;SampleGrabber: ISampleGrabber;VideoFrameStep: IVideoFrameStep;(1)然后需要使用CoCreateInstance函数创建一个Filter Graph Manager 实例,CoCreateInstance(TGUID(CLSID_FilterGraph),nil, CLSCTX_INPROC_SERVER,TGUID(IID_IGraphBuilder),GraphBuilder)因为需要抓图使用IsampleGrabber接口,需要创建SampleGrabber实例,var Filter: IBaseFilter; CoCreateInstance(CLSID_SampleGrabber, nil, CLSCTX_INPROC_SERVER,IID_IBaseFilter, Filter); (2) 调用QueryInterface函数获取来获取指针,好以后操作控制Filter.QueryInterface(IID_ISampleGrabber, SampleGrabber);GraphBuilder.AddFilter(Filter, 'Grabber');GraphBuilder.QueryInterface(IID_IMediaControl, MediaControl);GraphBuilder.QueryInterface(IID_IMediaPosition, MediaPosition);GraphBuilder.QueryInterface(IID_IMediaSeeking, MediaSeeking);GraphBuilder.QueryInterface(IID_IMediaEventEx, MediaEventEx);GraphBuilder.QueryInterface(IID_IVideoFrameStep, VideoFrameStep);GraphBuilder.QueryInterface(IID_IBasicAudio, BasicAudio);GraphBuilder.QueryInterface(IID_IBasicVideo, BasicVideo);GraphBuilder.QueryInterface(IID_IVideoWindow, VideoWindow);当然为了安全起见,可以对以上每个过程进行是否成功判断,给出信息,否则很有可能出现问题找不到头绪。
好了,一切准备成功,就可以进入第三步,开始我们的控制操作了。
(3)通过接口提供的函数开始控制哦,差点忘记一件重要的事情,在上面调用QueryInterface之前,还有两件重要的事情要做,第一,要建立一个Unicode(wide character)字符串,保存文件名。
var _wfile: array[0..MAX_PATH - 1] of wchar;MultiByteToWideChar(CP_ACP, 0, pChar(播放文件名), -1, @_wfile, MAX_PATH);然后需要成功RenderFile才可以控制操作GraphBuilder.RenderFile(_wfile, nil);XML:namespace prefix = o ns = "urn:schemas-microsoft-com:Office:office" />当然在显示的时候要把显示窗体和控件关连起来,这里需要通过IvideoWindow接口方法,VideoWindow. put_Owner(Edit1.Handle);VideoWindow. put_Windows tyle(DSVIDEO_WINDOW_CHILD_STYLE);VideoWindow.SetWindowPosition(0,0, Edit1.ClientWidth, Edit1.ClientHeight);得到图象的一些必要信息,使用IbasicVideo接口中的方法,一些变量自己定义,BasicVideo.GetVideoSize(VideoWidth, VideoHeight);BasicVideo.get_BitRate(VideoBitRate);BasicVideo.get_AvgTimePerFrame(PerFrame);得到当前文件的总时间以及播放时间,需要使用ImediaSeeking接口方法,MediaSeeking.GetDuration(Duration);//得到总时间MediaSeeking.GetCurrentPosition(CurrentPos);//得到当前播放时间也可以通过IMediaSeeking::SetPositions方法设置开始和结束时间。