DirectShow 获取音视频输入设备列表

开发环境：Win10 + VS2015

本文介绍一个 "获取音频视频输入设备列表" 的示例代码。

效果图

代码下载

代码下载（VC2015）：Github - DShow_simpleVideo

实现代码

DS_GetAudioVideoInputDevices.h

/* ----------------------------------------------------------
文件名称：DS_AudioVideoDevices.h

功能描述：
获取音频视频输入设备列表

接口函数：
DS_GetAudioVideoInputDevices
------------------------------------------------------------ */
#pragma once

#include <windows.h>
#include <vector>
#include <dshow.h>

#ifndef MACRO_GROUP_DEVICENAME
#define MACRO_GROUP_DEVICENAME

#define MAX_FRIENDLY_NAME_LENGTH    128
#define MAX_MONIKER_NAME_LENGTH     256

typedef struct _TDeviceName
{
    WCHAR FriendlyName[MAX_FRIENDLY_NAME_LENGTH];   // 设备友好名
    WCHAR MonikerName[MAX_MONIKER_NAME_LENGTH];     // 设备Moniker名
} TDeviceName;
#endif

#ifdef __cplusplus
extern "C"
{
#endif

    /*
    功能：获取音视频输入设备列表
    参数说明：
    vectorDevices：用于存储返回的设备友好名及Moniker名
    guidValue：
    CLSID_AudioInputDeviceCategory：获取音频输入设备列表
    CLSID_VideoInputDeviceCategory：获取视频输入设备列表
    返回值：
    错误代码
    说明：
    基于DirectShow
    列表中的第一个设备为系统缺省设备
    capGetDriverDescription只能获得设备驱动名
    */
    HRESULT DS_GetAudioVideoInputDevices(std::vector<TDeviceName> &vectorDevices, REFGUID guidValue);

#ifdef __cplusplus
}
#endif

DS_GetAudioVideoInputDevices.cpp

#include "stdafx.h"
#include "DS_AudioVideoDevices.h"

// 用到的DirectShow SDK链接库
#pragma comment(lib, "Strmiids.lib")

// 获取音视频输入设备列表
HRESULT DS_GetAudioVideoInputDevices(std::vector<TDeviceName> &vectorDevices, REFGUID guidValue)
{
    TDeviceName name;
    HRESULT hr;

    // 初始化vector
    vectorDevices.clear();

    // 初始化COM
    hr = CoInitializeEx(NULL, COINIT_APARTMENTTHREADED);
    if (FAILED(hr))
    {
        return hr;
    }

    // 创建系统设备枚举器实例
    ICreateDevEnum *pSysDevEnum = NULL;
    hr = CoCreateInstance(CLSID_SystemDeviceEnum, NULL, CLSCTX_INPROC_SERVER, IID_ICreateDevEnum, (void **)&pSysDevEnum);
    if (FAILED(hr))
    {
        CoUninitialize();
        return hr;
    }

    // 获取设备类枚举器
    IEnumMoniker *pEnumCat = NULL;
    hr = pSysDevEnum->CreateClassEnumerator(guidValue, &pEnumCat, 0);
    if (hr == S_OK)
    {
        // 枚举设备名称
        IMoniker *pMoniker = NULL;
        ULONG cFetched;
        while (pEnumCat->Next(1, &pMoniker, &cFetched) == S_OK)
        {
            IPropertyBag *pPropBag;
            hr = pMoniker->BindToStorage(NULL, NULL, IID_IPropertyBag, (void **)&pPropBag);
            if (SUCCEEDED(hr))
            {               
                VARIANT varName;
                VariantInit(&varName);

                // 获取设备友好名
                hr = pPropBag->Read(L"FriendlyName", &varName, NULL);
                if (SUCCEEDED(hr))
                {
                    // 拷贝设备友好名到name.FriendlyName
                    StringCchCopy(name.FriendlyName, MAX_FRIENDLY_NAME_LENGTH, varName.bstrVal);

                    // 获取设备Moniker名
                    LPOLESTR pOleDisplayName = reinterpret_cast<LPOLESTR>(CoTaskMemAlloc(MAX_MONIKER_NAME_LENGTH * 2));
                    if (pOleDisplayName != NULL)
                    {
                        hr = pMoniker->GetDisplayName(NULL, NULL, &pOleDisplayName);
                        if (SUCCEEDED(hr))
                        {
                            // 拷贝设备Moniker名到name.MonikerName
                            StringCchCopy(name.MonikerName, MAX_MONIKER_NAME_LENGTH, pOleDisplayName);
                            vectorDevices.push_back(name);
                        }

                        CoTaskMemFree(pOleDisplayName);
                    }
                }

                VariantClear(&varName);
                pPropBag->Release();
            }

            pMoniker->Release();
        } // End for While

        pEnumCat->Release();
    }

    pSysDevEnum->Release();
    CoUninitialize();

    return hr;
}

DShow_getVideoDevices.cpp

#include "stdafx.h"
#include <iostream>
#include <vector>
#include <dshow.h>
#include "DS_AudioVideoDevices.h"

// 用到的DirectShow SDK链接库
#pragma comment(lib,"strmiids.lib")

int _tmain(int argc, _TCHAR* argv[])
{
    std::vector<TDeviceName> vectorDevices;

    // 获取音视频输入设备列表
    DS_GetAudioVideoInputDevices(vectorDevices, CLSID_VideoInputDeviceCategory);

    // 打印"设备友好名"和"设备Moniker名"（摄像头）
    for (unsigned int i = 0; i < vectorDevices.size(); i++)
        std::wcout << vectorDevices[i].FriendlyName << " | " << vectorDevices[i].MonikerName << std::endl;

    return 0;
}

参考：

基于DirectShow获取音频视频输入设备列表

DirectShow 视频采集

1.使用DShow获取本机的视音频设备和自带编解码器列表