首页 > 代码库 > DirectShow基础编程 源Filter CSource CSourceStream (转)
DirectShow基础编程 源Filter CSource CSourceStream (转)
DirectShow是微软定义的一套接口集合,由不同的接口组成,例如:IBaseFilter,IPin。这些接口之间的关系形成了DirectShow的架构。
DirectX SDK提供了一个C++的BaseClasses,是这些接口的实现。这些实现已经很成熟完善,因此我们不需要重新开发一套类库去实现DirctShow的接口,直接使用就可以。
DirectShow编程就是Filter编程,根据功能实现不同的Filter。推模式的源Filter一般从CSource派生,在派生类中实现特殊的功能,而CSource类使用CSourceStream派生的pin。那么,推模式的源Filter编写就是实现这两个类。
- class CSource : public CBaseFilter
- {
- public:
- CSource(TCHAR *pName, LPUNKNOWN lpunk, CLSID clsid, HRESULT *phr);
- CSource(TCHAR *pName, LPUNKNOWN lpunk, CLSID clsid);
- ~CSource();
- int GetPinCount(void);
- CBasePin *GetPin(int n);
- CCritSec* pStateLock(void) { return &m_cStateLock; }
- HRESULT AddPin(CSourceStream *);
- HRESULT RemovePin(CSourceStream *);
- STDMETHODIMP FindPin(LPCWSTR Id, IPin ** ppPin);
- int FindPinNumber(IPin *iPin);
- protected:
- int m_iPins;
- CSourceStream **m_paStreams;
- CCritSec m_cStateLock;
- };
CSource类从CBaseFilter类派生:
成员:
CSourceStream **m_paStreams; 源Filter可以支持多个输出pin,因此使用动态数组记录pin指针。
int m_iPins; pin的个数。
方法:
HRESULT AddPin(CSourceStream *);添加pin。
HRESULT RemovePin(CSourceStream *);移除pin。
STDMETHODIMP FindPin(LPCWSTR Id, IPin ** ppPin);查找pin。
int GetPinCount(void);获取pin个数。
可见,CSource类就是对pin的管理。更多的功能,由CBaseFilter实现。实现自己的CSource类只需要做两件事:提供实例化接口;实例化输出pin。
实例化接口:
- CUnknown * WINAPI CMySource::CreateInstance(LPUNKNOWN lpunk, HRESULT *phr)
- {
- CUnknown *punk = new CMySource(lpunk, phr);
- return punk;
- }
此接口类似这样的固定格式。
实例化输出pin:
- CMySource::CMySource(LPUNKNOWN lpunk, HRESULT *phr)
- : CSource(..., lpunk, CLSID_...)
- {
- CMyOutputPin* pOutPin = new CMyOutputPin(phr, this);
- if(FAILED(*phr))
- {
- RemovePin(pOutPin);
- pOutPin->Release();
- }
- }
在构造函数中实例化输出pin,输出pin的构造函数会自动把pin添加到CMySource中。
- class CSourceStream : public CAMThread, public CBaseOutputPin
- {
- public:
- CSourceStream(TCHAR *pObjectName, HRESULT *phr, CSource *pms, LPCWSTR pName);
- virtual ~CSourceStream(void);
- protected:
- CSource *m_pFilter;
- virtual HRESULT FillBuffer(IMediaSample *pSamp) PURE;
- protected:
- virtual HRESULT CheckMediaType(const CMediaType *pMediaType);
- virtual HRESULT GetMediaType(int iPosition, CMediaType *pMediaType);
- };
转自: http://blog.csdn.net/bwmwm/article/details/5442259
输出pin从CBaseOutputPin派生,CSource类必须使用CSourceStream的派生类做输出pin。
成员:
CSource *m_pFilter;记录Filter的指针,通过构造函数赋值。
方法:
virtual HRESULT FillBuffer(IMediaSample *pSamp) PURE;填充数据,PURE被定义为=0,CSourceStream是一个抽象类,不能实例化,派生类必须实现这个函数。函数的实现中需要做的就是像参数传入的IMediaSample中填数据,这个数据会被传到下游的Filter。
virtual HRESULT GetMediaType(int iPosition, CMediaType *pMediaType);这个函数虽然不是一个纯虚函数,但是,我们必须重新现在它,来获得自定义的媒体类型。
virtual HRESULT CheckMediaType(const CMediaType *pMediaType);连接的两个pin之间匹配媒体类型,在此函数的实现中,可以把主类型子类型等等有必要比较的数据进行一遍比较,完全满足则返回成功,否则返回失败,匹配失败,则连接失败。因此,连接的过程实际上就是匹配媒体类型的过程,CheckMediaType最终是在CBasePin::Connect()中被使用。
virtual HRESULT DecideBufferSize(IMemAllocator * pAlloc,ALLOCATOR_PROPERTIES * ppropInputRequest) PURE;在CBaseOutputPin中声明这个纯虚函数,因此,派生类中必须实现,这个函数是在协商存储空间的时候决定数据的大小。
通常情况下,一个源Filter只需要自己实现以上提到的内容,其他的都有固定的格式。固定格式可以参照SDK中ball这个例子。
DirectShow基础编程 源Filter CSource CSourceStream (转)