视频捕获之如何使用系统设备枚举器

关注

原创最新推荐文章于 2026-05-18 06:35:45 发布 1.7k 阅读 AI 写同款· GEO 优化 ›

AI权益加码！Claude Code、Cursor等20+工具免费用！购周边限时加赠Coding Plan Lite，畅享主流AI工具！学习进阶更高效！阅读详情

如何使用系统设备枚举器

系统设备枚举器为我们按类型枚举已注册在系统中的Fitler提供了统一的方法。而且它能够区分不同的硬件设备，即便是同一个Filter支持它们。这对那些使用Windows驱动模型和KSProxy Filter的设备来说是非常有用的。系统设备枚举器对它们按不同的设备实例进行对待（译注：虽然它们支持相同Filter）。

当我们利用系统设备枚举器查询设备的时候，系统设备枚举器为特定类型的设备（如，音频捕获和视频压缩）生成了一张枚举表（Enumerator）。类型枚举器（Category enumerator）为每个这种类型的设备返回一个Moniker，类型枚举器自动把每一种即插即用的设备包含在内。

按如下的步骤使用系统设备枚举器：

1．调用方法CoCreateInstance生成系统设备枚举器。类标识（CLSID）为CLSID_SystemDeviceEnum。

2．调用ICreateDevEnum::CreateClassEnumerator方法生成类型枚举器，参数为你想要得到的类型的CLSID，该方法返回一个IEnumMoniker接口指针，如果指定的类型（是空的）或不存在，函数ICreateDevEnum::CreateClassEnumerator将返回S_FALSE而不是错误代码，同时IEnumMoniker指针（译注：通过参数返回）也是空的，这就要求我们在调用CreateClassEnumerator的时候明确用S_OK进行比较而不是使用宏SUCCEEDED。

3．使用IEnumMoniker::Next方法依次得到IEnumMoniker指针中的每个moniker。该方法返回一个IMoniker接口指针。当Next到达枚举的底部，它的返回值仍然是S_FALSE，这里我们仍需要用S_OK来进行检验。

4．想要得到该设备较为友好的名称（例如想要在用户界面中进行显示），调用IMoniker::BindToStorage方法。

5．如果想要生成并初始化管理该设备的Filter调用3返回指针的IMonitor::BindToObject方法，接下来调用IFilterGraph::AddFilter把该Filter添加到视图中。

下图说明了上述步骤：

下面的代码示例了如何枚举用户系统中的视频压缩器，为了简化，只给出了很少的错误检查。

//生成系统设备枚举器.

HRESULT hr;

ICreateDevEnum *pSysDevEnum = NULL;

hr = CoCreateInstance(CLSID_SystemDeviceEnum, NULL, CLSCTX_INPROC_SERVER,

    IID_ICreateDevEnum, (void **)&pSysDevEnum);

if (FAILED(hr))

    return hr;

// 获得视频压缩的类枚举器（Class enumerator）.

IEnumMoniker *pEnumCat = NULL;

hr = pSysDevEnum->CreateClassEnumerator(CLSID_VideoCompressorCategory, &pEnumCat, 0);

if (hr == S_OK)

    // 枚举其中的 moniker.

    IMoniker *pMoniker = NULL;

    ULONG cFetched;

    while(pEnumCat->Next(1, &pMoniker, &cFetched) == S_OK)

        IPropertyBag *pPropBag;

        hr = pMoniker->BindToStorage(0, 0, IID_IPropertyBag,

            (void **)&pPropBag);

        if (SUCCEEDED(hr))

            //如下，得到Filter的友好名称:

            VARIANT varName;

            VariantInit(&varName);

            hr = pPropBag->Read(L"FriendlyName", &varName, 0);

            if (SUCCEEDED(hr))

                //在你的用户界面上面显示.

            VariantClear(&varName);

            // 如下，生成该filter的实例:

            IBaseFilter *pFilter;

            hr = pMoniker->BindToObject(NULL, NULL, IID_IBaseFilter,

                (void**)&pFilter);

            //将Filter加入到Graph.

            //后面必须记得释放pFilter.

            pPropBag->Release();

        pMoniker->Release();

    pEnumCat->Release();

pSysDevEnum->Release();

设备Moniker

IMoniker::GetDisplayName方法返回moniker的名字。你可以把这个名字传递给IFilterGraph2::AddSourceFilterForMoniker，这样可以生成该设备的捕获Filter。

LPOLESTR strName = NULL;

IBaseFilter pSrc = NULL;

hr = pMoniker->GetDisplayName(NULL, NULL, &strName);

if (SUCCEEDED(hr))

    // 得到IFilterGraph2的Filter Graph Manager.

    IFilterGraph2 *pFG2 = NULL;

    hr = pGraph->QueryInterface(IID_IFilterGraph2, (void**)&pFG2);

    if (SUCCEEDED(hr))

        hr = pFG2->AddSourceFilterForMoniker(pMoniker, 0, L"Source", &pSrc);

        pFG2->Release();

    CoTaskMemFree(strName);

// 如果成功，记得释放pSrc.

虽然，用上述方法得到的名字也有较好的可读性，但是我们一般不把它显示给用户，如前面所示，我们一般用从IPropertyBag得到的名字。

方法IMoniker::ParseDisplayName和MkParseDisplayName可以用来生成指定filter类型的设备的moniker。名字以“@device:*:{category-clsid}”，代表了类型的GUID，默认的moniker是设备枚举器中的第一个moniker。

//视频捕获类型

WCHAR szMon[] = L"@device:*:{860BB310-5D01-11d0-BD3B
        
        
         -00A
        
        
         0C
        911CE86}";

IBindCtx *pBindCtx;

hr = CreateBindCtx(0, &pBindCtx);

ULONG chEaten = 0;

IMoniker *pMoniker = 0;

hr = MkParseDisplayName(pBindCtx, szMon, &chEaten, &pMoniker);

pBindCtx->Release();

if (SUCCEEDED(hr))

    // 得到名字或绑定至DirectShow Filter.

    pMoniker->Release();

标签

#filter #null #graph #windows #server

本内容遵循 CC 4.0 BY-SA 版权协议

如何枚举系统的视音频采集设备用Directshow SDK很容易实现该功能，但是开发者必须了解Directshow SDK的一些基础知识，对于不了解Directshow的开发员就有点头疼了。为了更方便他们开发，我封装了一个动态库，可以枚举系统的视音频采集设备（仅支持Windows系统），动态库使用非常简单，因为只有一个接口： //枚举指定类型的所有采集设备的名称 ENUMDEVICE_API HRESULT Enu... 阅读详情

视频捕获 之 如何使用系统设备枚举器

相关推荐

视频捕获之如何使用系统设备枚举器