如何用Media Foundation API创建虚拟摄像头并解决类未注册错误

问题描述 #

想用Media Foundation API创建可被Skype、Teams、GMeet等应用识别的虚拟摄像头，已用Qt C++编写代码，但启动虚拟摄像头时抛出HRESULT -2147221164（类未注册）错误。作为Media Foundation API新手，参考过VCAMSAMPLE代码仍未解决，求问如何为指定CLSID注册类？

代码示例 #

#include "mainwindow.h"
#include "ui_mainwindow.h"

#include <QMessageBox>
#include <QPushButton>

#include <mfobjects.h>
#include <mfplay.h>
#include <mfidl.h>
#include <mfapi.h>
#include <mfobjects.h>
#include <mfidl.h>
#include <mferror.h>
#include <Windows.h>
#include <comdef.h>
#include <string>
#include <mfapi.h>
#include <mfobjects.h>
#include <QDebug>
#include <QCoreApplication>
#include <QSettings>
#include <QFileInfo>

// Registry utility function
QString GUIDToString(const GUID& guid) {
    wchar_t guidString[39];  // 38 characters for GUID + null terminator
    StringFromGUID2(guid, guidString, sizeof(guidString) / sizeof(wchar_t));
    return QString::fromWCharArray(guidString);
}

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
    ui->setupUi(this);
    setWindowTitle("Virtual Camera Example");

    HRESULT hr = MFStartup(MF_VERSION);
    if (FAILED(hr)) {
        qDebug() << "Failed to initialize Media Foundation. HRESULT: " << QString::number(hr, 16);
        return;
    }

    startVirtualCamera();
}

// Start virtual camera
void MainWindow::startVirtualCamera()
{
    HRESULT hr = S_OK;

    // Virtual Camera GUID
    GUID CLSID_VCam = {0x3cad447d, 0xf283, 0x4af4, {0xa3, 0xb2, 0x6f, 0x53, 0x63, 0x30, 0x9f, 0x51}};
    std::wstring cameraName = L"Vita";

    // Create Virtual Camera
    hr = MFCreateVirtualCamera(
        MFVirtualCameraType_SoftwareCameraSource,
        MFVirtualCameraLifetime_Session,
        MFVirtualCameraAccess_CurrentUser,
        cameraName.c_str(),
        L"{3cad447d-f283-4af4-a3b2-6f5363309f51}",
        nullptr,
        0,
        &_vcam);
    qDebug() << "virtual cam clsid" <<GUIDToString(CLSID_VCam).toStdWString().c_str();
    if (FAILED(hr))
    {
        QMessageBox::critical(this, "Error", "Failed to create virtual camera");
        return;
    }

    hr = _vcam->Start(nullptr);
    if (FAILED(hr))
    {
        qDebug() << "Error Failed to start virtual camera" << hr;
        return;
    }

    QMessageBox::information(this, "Success", "Virtual Camera Started");
}

问题分析与解决方案 #

1. 修正MFCreateVirtualCamera参数错误 #

你代码中手动传入自定义CLSID是错误用法：MFCreateVirtualCamera的第5个参数pszDeviceInstanceId并非要求传入自定义CLSID，而是用于指定已存在的虚拟摄像头设备实例ID。传入未注册的CLSID会导致系统找不到对应的COM类，触发“类未注册”错误。

快速修复：将该参数改为nullptr，让系统自动生成临时设备实例ID：

hr = MFCreateVirtualCamera(
    MFVirtualCameraType_SoftwareCameraSource,
    MFVirtualCameraLifetime_Session,
    MFVirtualCameraAccess_CurrentUser,
    cameraName.c_str(),
    nullptr,  // 改为nullptr，由系统分配设备ID
    nullptr,
    0,
    &_vcam);

2. 自定义CLSID的注册步骤（如需持久化设备） #

如果需要创建重启后仍存在的持久化虚拟摄像头，必须注册自定义CLSID对应的COM类：

• 实现必要接口：虚拟摄像头类必须实现IMFMediaSource、IMFSourceReader等Media Foundation核心接口
• 导出注册函数：在DLL中导出DllRegisterServer和DllUnregisterServer函数，用于处理注册表写入
• 编写注册表脚本：创建.reg文件，将CLSID注册到HKEY_CLASSES_ROOT\CLSID\{你的CLSID}，指定DLL路径、线程模型等信息
  示例.reg内容：

  Windows Registry Editor Version 5.00
  
  [HKEY_CLASSES_ROOT\CLSID\{3cad447d-f283-4af4-a3b2-6f5363309f51}]
  @="Vita Virtual Camera"
  
  [HKEY_CLASSES_ROOT\CLSID\{3cad447d-f283-4af4-a3b2-6f5363309f51}\InprocServer32]
  @="C:\\Path\\To\\Your\\VirtualCamera.dll"
  "ThreadingModel"="Both"
  

• 执行注册：以管理员身份运行regsvr32.exe C:\Path\To\Your\VirtualCamera.dll完成注册

3. 环境验证 #

• 确保系统为Windows 10 20H1（19041）及以上版本，MFCreateVirtualCamera仅支持该版本之后的系统
• 确认Media Foundation已启用：控制面板→程序→启用或关闭Windows功能→勾选“媒体功能”

内容的提问来源于stack exchange，提问作者CodingGeekwithglasses