C++ – Windows获取电脑上摄像头设备数目、名字以及id

1 Windows系统获取摄像头信息

1.1 ICreateDevEnum::CreateClassEnumerator

在Windows系统上如果要获取摄像头的数目、摄像头的名字等信息，就需要使用Windows的系统API，这里的我们使用的API函数为ICreateDevEnum::CreateClassEnumerator，其

函数原型如下

  HRESULT CreateClassEnumerator(
  REFCLSID clsidDeviceClass,
  IEnumMoniker **ppEnumMoniker,
  DWORD dwFlags
);

函数参数：

• clsidDeviceClass：指定设备类型的标志符，具体的相关标志符可以查看Filter Categories，其中摄像头输入设备对应的标志符为CLSID_VideoInputDeviceCategory，所有的可用标志符可参考下图
  
• ppEnumMoniker：接收IEnumMoniker接口指针的变量的地址
• dwFlags：零个或者多个的枚举标志符，如果设置为零，则枚举每个过滤器，如果设置了特定的过滤器标志，则只枚举相应标志的设备

函数返回值：

• S_OK：成功
• E_OUTOFMEMORY：没有足够的可用内存来创建枚举器
• S_FALSE：clsidDeviceClass指定的类别不存在或为空
• E_POINTER：参数为空指针

1.2 使用ICreateDevEnum::CreateClassEnumerator枚举摄像头，获取摄像头信息

我们可以使用ICreateDevEnum::CreateClassEnumerator枚举视频输入设备，具体的可参考以下代码

#include <iostream>
#include "strmif.h"
#include <initguid.h>
#include <vector>
#include <string>

#pragma comment(lib, "setupapi.lib")

#define VI_MAX_CAMERAS 20
DEFINE_GUID(CLSID_SystemDeviceEnum, 0x62be5d10, 0x60eb, 0x11d0, 0xbd, 0x3b, 0x00, 0xa0, 0xc9, 0x11, 0xce, 0x86);
DEFINE_GUID(CLSID_VideoInputDeviceCategory, 0x860bb310, 0x5d01, 0x11d0, 0xbd, 0x3b, 0x00, 0xa0, 0xc9, 0x11, 0xce, 0x86);
DEFINE_GUID(IID_ICreateDevEnum, 0x29840822, 0x5b84, 0x11d0, 0xbd, 0x3b, 0x00, 0xa0, 0xc9, 0x11, 0xce, 0x86);

//列出摄像头
std::vector<std::string> listCameraDevices()
{
    std::vector<std::string> camera_list;

    ICreateDevEnum* pDevEnum = NULL;
    IEnumMoniker* pEnum = NULL;
    int deviceNum = 0;

    CoInitialize(NULL);

    HRESULT hr = CoCreateInstance(
        CLSID_SystemDeviceEnum,
        NULL,
        CLSCTX_INPROC_SERVER,
        IID_ICreateDevEnum,
        reinterpret_cast<void**>(&pDevEnum)
    );

    if (SUCCEEDED(hr))
    {
        hr = pDevEnum->CreateClassEnumerator(CLSID_VideoInputDeviceCategory, &pEnum, 0);
        if (hr == S_OK) {

            IMoniker* pMoniker = NULL;
            while (pEnum->Next(1, &pMoniker, NULL) == S_OK)
            {
                IPropertyBag* pPropBag;
                hr = pMoniker->BindToStorage(0, 0, IID_IPropertyBag,
                    (void**)(&pPropBag));

                if (FAILED(hr)) {
                    pMoniker->Release();
                    continue; // Skip this one, maybe the next one will work.
                }

                VARIANT varName;
                VariantInit(&varName);
                hr = pPropBag->Read(L"Description", &varName, 0);
                if (FAILED(hr))
                {
                    hr = pPropBag->Read(L"FriendlyName", &varName, 0);
                }

                if (SUCCEEDED(hr))
                {
                    hr = pPropBag->Read(L"FriendlyName", &varName, 0);
                    int count = 0;
                    char tmp[255] = { 0 };
                    while (varName.bstrVal[count] != 0x00 && count < 255)
                    {
                        tmp[count] = (char)varName.bstrVal[count];
                        count++;
                    }

                    camera_list.push_back(tmp);
                }

                pPropBag->Release();
                pPropBag = NULL;
                pMoniker->Release();
                pMoniker = NULL;

                deviceNum++;
            }

            pDevEnum->Release();
            pDevEnum = NULL;
            pEnum->Release();
            pEnum = NULL;
        }
    }

    return camera_list;
}



int main()
{
    std::vector<std::string> camera_name_list = listCameraDevices();
    std::cout << "摄像头个数：" << camera_name_list.size() << std::endl;
    for (int i = 0; i < camera_name_list.size(); ++i) 
    {
        std::cout << " ID: " << i << " : " << " Name: " << camera_name_list[i] << std::endl;
    }

    return 0;
}

在以上代码的参考下，我们可以更改ICreateDevEnum::CreateClassEnumerator的clsidDeviceClass参数，枚举电脑上的麦克风设备并获取相关的信息。

参考链接

• https://learn.microsoft.com/en-us/previous-versions/ms784969(v=vs.85)