DirectShow开发快速入门之慨述（二）

3、媒体类型

　　因为Directshow是基于com组件的，就需要有一种方式来描述filter graph每一个点的数据格式，例如，我们还以播放AVI文件为例，数据以RIFF块的形式进入graph中，然后被分割成视频和音频流，视频流有一系列的压缩的视频桢组成，解压后，视频流由一系列的无压缩的位图组成，音频流也要走同样的步骤。

Media Types: How DirectShow Represents Formats
　　媒体类型是一种很普遍的，可以扩展的用来描述数字媒体格式的方法，当两个filter连接的时候，他们会就采用某一种媒体类型达成一致的协议。媒体类型定义了处于源头的filter将要给下游的filter发送什么样的数据，以及数据的physical layout。如果两个filter不能够支持同一种的媒体类型，那么他们就没法连接起来。

　　对于大多数的应用来说，也许你不用考虑媒体类型，但是，有些应用程序中，你会直接应用到媒体类型的。

　　媒体类型是通过AM_MEDIA_TYPE结构定义的，看看原始定义吧

typedef struct _MediaType {
　 GUID majortype;
　 GUID subtype;
　 BOOL bFixedSizeSamples;
　 BOOL bTemporalCompression;
　 ULONG lSampleSize;
　 GUID formattype;
　 IUnknown *pUnk;
　 ULONG cbFormat;
　 [size_is(cbFormat)] BYTE *pbFormat;
} AM_MEDIA_TYPE;
　　Major type:是一个GUID，用来定义数据的主类型，包括，音频，视频，unparsed字节流，MIDI数据，等等，具体可以参考msdn。

　　Subtype:子类型，也是一个GUID，用来进一步的细化数据格式，例如，在视频主类型中，还包括RGB-24, RGB-32, UYVY等等一些子类型，在音频主类型中还包括PCM audio, MPEG-1 payload等类型，子类型提供了比主类型更详细的信息，但是并没有定义所有的格式，例如，视频的子类型并没有定义图像大小，桢率。这些由下面的字段定义。

　　bFixedSizeSamples当这个值为TRUE时，表示sample大小固定。

　　bTemporalCompression当这个值为TRUE时，表示sample采用了临时压缩格式，表明不是所有的桢都是关键桢，如果为FALSE，表明所有的都是关键桢。

　　lSampleSize 表示sample的大小。对于压缩的数据，这个值可能为零。
　　
　　Formattype一个GUID值，用来表明内存块的格式。包括如下：FORMAT_None，FORMAT_DvInfo，FORMAT_MPEGVideo，FORMAT_MPEG2Video，FORMAT_VideoInfo，FORMAT_VideoInfo2，FORMAT_WaveFormatEx，GUID_NULL。

　　pUnk该参数没有用到。

　　cbFormat内存块的大小。

　　pbFormat指向内存块的指针。

　　下面我们看一段代码，看看filter如何检测媒体类型的。

HRESULT CheckMediaType(AM_MEDIA_TYPE *pmt)
{
　 if (pmt == NULL) return E_POINTER;
　 // Check the major type. We’re looking for video.
　 if (pmt->majortype != MEDIATYPE_Video)
　 {
　　 return VFW_E_INVALIDMEDIATYPE;
　 }
　 // Check the subtype. We’re looking for 24-bit RGB.
　 if (pmt->subtype != MEDIASUBTYPE_RGB24)
　 {
　　 return VFW_E_INVALIDMEDIATYPE;
　 }
　 // Check the format type and the size of the format block.
　 if ((pmt->formattype == FORMAT_VideoInfo) && (pmt->cbFormat >= sizeof(VIDEOINFOHEADER) &&
(pmt->pbFormat != NULL))
　 {
　　 // Now it’s safe to coerce the format block pointer to the
　　 // correct structure, as defined by the formattype GUID.
　　 VIDEOINFOHEADER *pVIH = (VIDEOINFOHEADER*)pmt->pbFormat;
　　 // Examine pVIH (not shown). If it looks OK, return S_OK.
　　 return S_OK;
　 }
　 return VFW_E_INVALIDMEDIATYPE;
}
　　下面简单介绍几个和 Media Type相关的函数：

　　AM_MEDIA_TYPE结构包含一个指向数据块的指针，因此，当你使用这个结构的时候，一定要小心内存分配，以防内存泄漏。

　　分配函数

　　1) AM_MEDIA_TYPE * WINAPI CreateMediaType(AM_MEDIA_TYPE const *pSrc );

　　这个函数分配一个新的AM_MEDIA_TYPE结构，包含特定格式的数据块。释放由这个函数分配的内存，可以调用DeleteMediaType函数

　　2) STDAPI CreateAudioMediaType(const WAVEFORMATEX *pwfx,AM_MEDIA_TYPE *pmt,BOOL bSetFormat);

　　该函数利用一个给定的WAVEFORMATIEX结构来初始化媒体类型，如果bsetFormat参数为TRUE，该函数就分配一块新的内存，如果原来的pmt已经包含内存，就有可能发生内存泄漏。为了避免内存泄漏，在调用这个函数前要调用FreeMediaType（），在这个函数返回之后，再次调用FreeMediaType（），释放format block。

　　3) HRESULT WINAPI CopyMediaType(AM_MEDIA_TYPE *pmtTarget,const AM_MEDIA_TYPE *pmtSource);

　　这个函数复制了一个结构到另一个结构中去。这个函数也要重新分配内存给目的结构，如果pmtTarget,已经包含一个内存块，就要内存泄漏，因此，在调用该函数前后都要调用FreeMediaType函数。

　　释放函数

　　4) void WINAPI DeleteMediaType( AM_MEDIA_TYPE *pmt);

　　无论是采用CoTaskMemAlloc函数还是用CreateMediaType函数分配的内存都可以用这个函数来释放，如果你没有连接基类的动态库，你可以用下面的代码

void MyDeleteMediaType(AM_MEDIA_TYPE *pmt)
{
　 if (pmt != NULL)
　 {
　　 MyFreeMediaType(*pmt); // 见下面的 FreeMediaType 函数
　　 CoTaskMemFree(pmt);
　 }
}
　　5) void WINAPI FreeMediaType( AM_MEDIA_TYPE& mt);

　　这个函数用来释放数据块的内存，如果要删除AM_MEDIA_TYPE结构，可以使用DeleteMediaType函数。

void MyFreeMediaType(AM_MEDIA_TYPE& mt)
{
　 if (mt.cbFormat != 0)
　 {
　　 CoTaskMemFree((PVOID)mt.pbFormat);
　　 mt.cbFormat = 0;
　　 mt.pbFormat = NULL;
　 }
　 if (mt.pUnk != NULL)
　 {
　　 // Unecessary because pUnk should not be used, but safest.
　　 mt.pUnk->Release();
　　 mt.pUnk = NULL;
　 }
}