最简单的基于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_TYPE。
GuidToString(mt->majortype)：把AM_MEDIA_TYPE的GUID转换成字符串（方便输出）。

【释放】

CoUninitialize()：释放CoInitialize()初始化的COM运行环境。

再附上一张代码中涉及到的接口之间的关系：



可以看出从上到下他们之间顺序的排列如下所示：

ICreateDevEnum-->IEnumMoniker-->IMoniker-->IBaseFilter-->IEnumPins-->IPin-->IEnumMediaTypes-->AM_MEDIA_TYPE

源代码

/**
* 最简单的Directshow信息显示例子
* Simplest DirectShow Info
*
* 雷霄骅 Lei Xiaohua
* leixiaohua1020@126.com
* 中国传媒大学/数字电视技术
* Communication University of China / Digital TV Technology
* http://blog.csdn.net/leixiaohua1020 *
* 本程序是一段获取DirectShow滤镜信息的代码。通过本代码可以获得
* DirectShow滤镜信息。适合初学者学习DirectShow。
*
* This code can be used to get Directshow Filter's information.
* Suitable for the beginner of DirectShow.
*/

#include "stdafx.h"
#include <dshow.h>
#include <atlconv.h>

#define OUTPUT_PIN       1
#define OUTPUT_MEDIATYPE 1

char* GuidToString(const GUID &guid)
{
int buf_len=64;
char *buf =(char *)malloc(buf_len);
_snprintf(
buf,
buf_len,
"{%08X-%04X-%04X-%02X%02X-%02X%02X%02X%02X%02X%02X}",
guid.Data1, guid.Data2, guid.Data3,
guid.Data4[0], guid.Data4[1],
guid.Data4[2], guid.Data4[3],
guid.Data4[4], guid.Data4[5],
guid.Data4[6], guid.Data4[7]);
//printf("%s\n",buf);
return buf;
}

int _tmain(int argc, _TCHAR* argv[])
{
USES_CONVERSION;
// Init COM
HRESULT hr=NULL;
hr= CoInitialize(NULL);
if (FAILED(hr)){
printf("Error, Can not init COM.");
return -1;
}
printf("===============Directshow Filters ===============\n");
ICreateDevEnum *pSysDevEnum = NULL;
hr = CoCreateInstance(CLSID_SystemDeviceEnum, NULL, CLSCTX_INPROC_SERVER,
IID_ICreateDevEnum, (void **)&pSysDevEnum);
if (FAILED(hr)){
return hr;
}

IEnumMoniker *pEnumCat = NULL;
//Category
/************************************************************************
Friendly Name	                      CLSID
-------------------------------------------------------------------------
Audio Capture Sources	              CLSID_AudioInputDeviceCategory
Audio Compressors	                  CLSID_AudioCompressorCategory
Audio Renderers	                      CLSID_AudioRendererCategory
Device Control Filters	              CLSID_DeviceControlCategory
DirectShow Filters	                  CLSID_LegacyAmFilterCategory
External Renderers	                  CLSID_TransmitCategory
Midi Renderers	                      CLSID_MidiRendererCategory
Video Capture Sources	              CLSID_VideoInputDeviceCategory
Video Compressors	                  CLSID_VideoCompressorCategory
WDM Stream Decompression Devices	  CLSID_DVDHWDecodersCategory
WDM Streaming Capture Devices	      AM_KSCATEGORY_CAPTURE
WDM Streaming Crossbar Devices	      AM_KSCATEGORY_CROSSBAR
WDM Streaming Rendering Devices	      AM_KSCATEGORY_RENDER
WDM Streaming Tee/Splitter Devices	  AM_KSCATEGORY_SPLITTER
WDM Streaming TV Audio Devices	      AM_KSCATEGORY_TVAUDIO
WDM Streaming TV Tuner Devices	      AM_KSCATEGORY_TVTUNER
WDM Streaming VBI Codecs	          AM_KSCATEGORY_VBICODEC
************************************************************************/
hr = pSysDevEnum->CreateClassEnumerator(CLSID_VideoCompressorCategory, &pEnumCat, 0);
//hr = pSysDevEnum->CreateClassEnumerator(CLSID_VideoInputDeviceCategory, &pEnumCat, 0);
//hr = pSysDevEnum->CreateClassEnumerator(CLSID_AudioCompressorCategory, &pEnumCat, 0);
//hr = pSysDevEnum->CreateClassEnumerator(CLSID_AudioInputDeviceCategory, &pEnumCat, 0);
//hr = pSysDevEnum->CreateClassEnumerator(CLSID_MediaMultiplexerCategory, &pEnumCat, 0);
//hr = pSysDevEnum->CreateClassEnumerator(CLSID_LegacyAmFilterCategory, &pEnumCat, 0);

if (hr != S_OK) {
pSysDevEnum->Release();
return -1;
}

IMoniker *pMoniker = NULL;
ULONG monikerFetched;
//Filter
while(pEnumCat->Next(1, &pMoniker, &monikerFetched) == S_OK){
IPropertyBag *pPropBag;
VARIANT varName;
IBaseFilter *pFilter;
hr = pMoniker->BindToStorage(0, 0, IID_IPropertyBag,(void **)&pPropBag);
if (FAILED(hr)){
pMoniker->Release();
continue;
}
VariantInit(&varName);
hr = pPropBag->Read(L"FriendlyName", &varName, 0);
//"FriendlyName": The name of the device.
//"Description": A description of the device.
//Filter Info================
printf("[%s]\n",W2A(varName.bstrVal));
VariantClear(&varName);
//========================
#if OUTPUT_PIN
hr = pMoniker->BindToObject(NULL, NULL, IID_IBaseFilter,(void**)&pFilter);
if (!pFilter){
continue;
}

IEnumPins * pinEnum = NULL;
IPin * pin = NULL;
ULONG pinFetched = 0;
if (FAILED(pFilter->EnumPins(&pinEnum))){
pinEnum->Release();
continue;
}
pinEnum->Reset();
//Pin Info
while (SUCCEEDED(pinEnum->Next(1, &pin, &pinFetched)) && pinFetched){
if (!pin){
continue;
}
PIN_INFO pinInfo;
if (FAILED(pin->QueryPinInfo(&pinInfo))){
continue;
}
printf("\t[Pin] ");
switch(pinInfo.dir){
case PINDIR_INPUT:printf("Dir:Input  \t");break;
case PINDIR_OUTPUT:printf("Dir:Output \t");break;
default:printf("Dir:Unknown\n");break;
}
printf("Name:%s\n",W2A(pinInfo.achName));

//MediaType
#if OUTPUT_MEDIATYPE
IEnumMediaTypes *mtEnum=NULL;
AM_MEDIA_TYPE   *mt=NULL;
if( FAILED( pin->EnumMediaTypes( &mtEnum )) )
break;
mtEnum->Reset();

ULONG mtFetched = 0;

while (SUCCEEDED(mtEnum->Next(1, &mt, &mtFetched)) && mtFetched){

printf("\t\t[MediaType]\n");
//Video
char *MEDIATYPE_Video_str=GuidToString(MEDIATYPE_Video);
//Audio
char *MEDIATYPE_Audio_str=GuidToString(MEDIATYPE_Audio);
//Stream
char *MEDIATYPE_Stream_str=GuidToString(MEDIATYPE_Stream);
//Majortype
char *majortype_str=GuidToString(mt->majortype);
//Subtype
char *subtype_str=GuidToString(mt->subtype);

printf("\t\t  Majortype:");
if(strcmp(majortype_str,MEDIATYPE_Video_str)==0){
printf("Video\n");
}else if(strcmp(majortype_str,MEDIATYPE_Audio_str)==0){
printf("Audio\n");
}else if(strcmp(majortype_str,MEDIATYPE_Stream_str)==0){
printf("Stream\n");
}else{
printf("Other\n");
}
printf("\t\t  Subtype GUID:%s",subtype_str);

free(MEDIATYPE_Video_str);
free(MEDIATYPE_Audio_str);
free(MEDIATYPE_Stream_str);
free(subtype_str);
free(majortype_str);
printf("\n");

}
#endif
pin->Release();

}
pinEnum->Release();

pFilter->Release();
#endif

pPropBag->Release();
pMoniker->Release();
}
pEnumCat->Release();
pSysDevEnum->Release();
printf("=================================================\n");
CoUninitialize();
return 0;
}

运行结果

程序运行的结果如下图所示。从图中可以看出，程序打印出了系统中DirectShow的Filter信息。每个Filter的信息中包含了它的Pin的信息。每个Pin中又包含了Pin中的MediaType信息。



可以通过定义在代码最前面宏 控制输出的Filter信息的类型。定义成“0”的话则不会输出该类的信息。如下所示。

#define OUTPUT_PIN       1
#define OUTPUT_MEDIATYPE 1

下载

Simplest DirectShow Example


项目主页

SourceForge：https://sourceforge.net/projects/simplestdirectshowexample/

Github：https://github.com/leixiaohua1020/simplest_directshow_example

开源中国：http://git.oschina.net/leixiaohua1020/simplest_directshow_example

CDSN下载地址：http://download.csdn.net/detail/leixiaohua1020/8348163

本程序包含了DirectShow开发的示例程序。适合DirectShow初学者进行学习。

它包含了以下几个子程序：

simplest_directshow_player: 最简单的基于DirectShow的视频播放器。

simplest_directshow_player_custom: 最简单的基于DirectShow的视频播放器（Custom）。

playerGUI: 最简单的基于DirectShow的播放器-图形界面版。

simplest_directshow_info: 最简单的Directshow信息显示例子。

simplest_directshow_filter: 目前还未完成。