最简单的基于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：描述媒体类型的结构体。
流程图
该流程图中涉及到以下函数：
【初始化】
【Filter的枚举】CoInitialize()：初始化COM运行环境。
CoCreateInstance(…,pSysDevEnum)：用指定的类标识符创建一个Com对象。在该示例中类标识符为“IID_ICreateDevEnum”，用于创建ICreateDevEnum。
pSysDevEnum->CreateClassEnumerator(…,pEnumCat)：通过ICreateDevEnum查询IEnumMoniker枚举接口，枚举指定类型目录下的设备Moniker（别名）。【Pin的枚举】
pEnumCat->Next(…,pMoniker)：通过IEnumMoniker查询下一个IMoniker接口。
pMoniker->BindToStorage(…,pPropBag)：通过IMoniker查询IPropertyBag接口（用于获取Filter信息）。
pPropBag->Read("FriendlyName")：通过IPropertyBag获取“FriendlyName”属性的值。pMoniker->BindToObject(…,pFilter)：通过IMoniker查询IBaseFilter接口（用于获取Filter，注意和BindToStorage()区别）。
pFilter->EnumPins(pinEnum)：通过IBaseFilter查询IEnumPins枚举接口。【MediaType的枚举】
pinEnum->Next(…,pin)：通过IEnumPins查询下一个IPin接口。pin->QueryPinInfo(PinInfo)：通过IPin获取Pin的信息。
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
* [email protected]
* 中国传媒大学/数字电视技术
* 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
#include
#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: 目前还未完成。