按设备名打开摄像头 - OpenCameraByName

函数简介

按设备友好名、DirectShow 的 video=... 串，或 Linux 下的设备路径（如 /dev/video0）打开摄像头，返回视频句柄。

接口名称

OpenCameraByName

DLL调用

OLA_HANDLE_RETURN OLA_CALL_TYPE OpenCameraByName(int64_t instance, OLA_STRING_INPUT deviceName);

参数说明

参数名	类型	说明
instance	长整数型	OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
deviceName	文本型	设备友好名、DirectShow 的 video=... 串，或 Linux 下如 /dev/video0 等设备路径。

示例

// Windows：DirectShow 常用 video=... 设备串；也可传系统枚举到的友好名（依实现而定）
int64_t videoHandle = OpenCameraByName(instance, "video=Integrated Camera");
// Linux：设备节点路径
// int64_t videoHandle = OpenCameraByName(instance, "/dev/video0");
if (videoHandle != 0) {
    CloseVideo(instance, videoHandle);
}

返回值

长整数型：视频句柄，失败返回 0。

注意事项

• Windows 下会优先尝试 DirectShow（video=设备名），失败再尝试默认后端。
• 返回的句柄用于后续的视频操作，使用完毕后需调用 CloseVideo 释放。
• 确保目标设备已连接且未被其他程序占用。