最简单的基于DirectShow的示例 获取Filter信息

               

=====================================================

最简单的基于DirectShow的示例文章列表：

最简单的基于DirectShow的示例：视频播放器

最简单的基于DirectShow的示例：视频播放器图形界面版

最简单的基于DirectShow的示例：视频播放器自定义版

最简单的基于DirectShow的示例：获取Filter信息

=====================================================

本文记录一个获取DirectShow的Filter信息的程序。该程序可以遍历当前系统中的DirectShow Filter并且将它们的信息打印到控制台中。通过本程序可以搞清楚DirectShow中Filter，Pin，MediaType等几个关键结构之间的关系，以及它们的信息的获取方法。

流程图

该程序的流程图如下所示。由于该图的尺寸比较大，在页面中显示不下，所以在相册中上传了一份：

查看大图

接口

该流程图中涉及到以下接口：

ICreateDevEnum *pSysDevEnum：设备列举接口。
IEnumMoniker *pEnumCat：Moniker（别名）枚举接口。
IMoniker *pMoniker：Moniker（别名）接口。
IPropertyBag *pPropBag：存储属性值的接口。
IBaseFilter *pFilter：Filter接口。
IEnumPins * pinEnum：Filter枚举接口。
IPin * pin： Pin接口。
PIN_INFO pinInfo：存储Pin的信息的结构体。
IEnumMediaTypes *mtEnum：MediaType枚举接口。

AM_MEDIA_TYPE   *mt：描述媒体类型的结构体。

流程图

该流程图中涉及到以下函数：

【初始化】

CoInitialize()：初始化COM运行环境。

CoCreateInstance(…,pSysDevEnum)：用指定的类标识符创建一个Com对象。在该示例中类标识符为“IID_ICreateDevEnum”，用于创建ICreateDevEnum。

【Filter的枚举】

pSysDevEnum->CreateClassEnumerator(…,pEnumCat)：通过ICreateDevEnum查询IEnumMoniker枚举接口，枚举指定类型目录下的设备Moniker（别名）。
pEnumCat->Next(…,pMoniker)：通过IEnumMoniker查询下一个IMoniker接口。
pMoniker->BindToStorage(…,pPropBag)：通过IMoniker查询IPropertyBag接口（用于获取Filter信息）。
pPropBag->Read("FriendlyName")：通过IPropertyBag获取“FriendlyName”属性的值。

pMoniker->BindToObject(…,pFilter)：通过IMoniker查询IBaseFilter接口（用于获取Filter，注意和BindToStorage()区别）。

【Pin的枚举】

pFilter->EnumPins(pinEnum)：通过IBaseFilter查询IEnumPins枚举接口。
pinEnum->Next(…,pin)：通过IEnumPins查询下一个IPin接口。

pin->QueryPinInfo(PinInfo)：通过IPin获取Pin的信息。

【MediaType的枚举】

pin->EnumMediaTypes(&mtEnum)：通过IPin查询IEnumMediaTypes枚举接口。
mtEnum->Next(…, &mt)：通过IEnumMediaTypes查询下一个AM_MEDIA_