windows虚拟显示器SDK开发和提供

背景

这周末闲来无事,整理了下虚拟显示器的源码,发现有几个项目都用到了,但是使用的功能不尽相同:
(1)最简单的运用仅仅是需要显示器的拔插;
(2)稍微复杂一点的是需要设置显示器的分辨率,包括标准的分辨率,如19201080,还包括非标准的分辨率,如1120900;
(3)再复杂一点的需要设置显示器名称、刷新频率、获取虚拟显示器屏幕图像信息。
再观察我的那几个项目,都重复的导入了源码,每次发现一个bug,改了一个,另外一个忘记同步了,造成代码维护的不便,所以此次将虚拟显示器部分的代码进行提取,单独封装成一个SDK,只要项目中有用到都使用这个SDK即可。

SDK的导出函数

此次SDK,为win7虚拟显示器和win10虚拟显示器做了统一处理,导出同样的接口,也就是说用户在调用时不再需要关注当前系统是win7还是win10,初步导出函数如下:

#include <Windows.h>

enum 
{
	USB_DEVICE_ERROR_SUCC = 0,
	USB_DEVICE_ERROR_FAILD,
	USB_DEVICE_ERROR_DEV_NOT_READY,/* 虚拟显示器刚刚插入,还没准备好 */
	USB_DEVICE_ERROR_INVALID_PARAMS/* 传入的参数不对 */
};


typedef struct _VMON_INFO
{
	BOOL bExist;/* 虚拟显示器是否存在 */
	BOOL bActive;/* 虚拟显示器是否处于激活状态 */
	BOOL bIndependent;/* 虚拟显示器是否独立(不和其他显示器复制)*/
	DISPLAYCONFIG_2DREGION  m_currentResolution;/* 当前虚拟显示器分辨率 */
	WCHAR szDisplayName[MAX_PATH];/* 虚拟显示器显示名称(可用于枚举分辨率列表)*/
}VMON_INFO;

typedef struct _MON_IMG_DATA
{
	UINT width;
	UINT height;
	UINT stride;
	PVOID pSurface;
}MON_IMG_DATA;

extern "C"
{
	/*
	*	创建MonitorDevice设备,用于对设备进行操作
	*	@return	失败返回false,成功返回true
	*	@remark 最后需要使用DestroyUsbDevice进行销毁
	*/
	__declspec(dllexport) HANDLE CreateMonitorDevice();

	/*
	*	插入虚拟显示器
	*	@param	handle[in]:CreateMonitorDevice返回的设备句柄
	*	@return	见返回错误码
	*	@remark
	*/
	__declspec(dllexport) int PlugInMonitor(HANDLE handle);

	/*
	*	设置分辨率
	*	@param	handle[in]:CreateMonitorDevice返回的设备句柄
	*	@param	rsl[in]:需要设置的分辨率,宽度最小值为800,高度最小值为600
	*	@return	见返回错误码
	*	@remark 设置低于800*600的分辨率会返回失败
	*/
	__declspec(dllexport) int SetCustomSolution(HANDLE handle, DISPLAYCONFIG_2DREGION rsl);

	/*
	*	等待虚拟显示器屏幕数据,屏幕画面有更新才返回
	*	@param	handle[in]:CreateMonitorDevice返回的设备句柄
	*	@return	见返回错误码
	*	@remark
	*/
	__declspec(dllexport) int WaitforMonitorImage(HANDLE handle, MON_IMG_DATA *imageData);

	/*
	*	取消等待屏幕图片,由于WaitMonitorImage是阻塞等待的,另一个线程可以取消等待,让WaitMonitorImage返回
	*	@param	handle[in]:CreateMonitorDevice返回的设备句柄
	*	@return	见返回错误码
	*	@remark
	*/
	__declspec(dllexport) int CancelWaitMonitorImage(HANDLE handle);

	/*
	*	拔出虚拟显示器
	*	@param	handle[in]:CreateMonitorDevice返回的设备句柄
	*	@return	见返回错误码
	*	@remark
	*/
	__declspec(dllexport) int PlugOutMonitor(HANDLE handle);

	/*
	*	销毁获取虚拟显示器信息
	*	@param	handle[in]:CreateMonitorDevice返回的设备句柄
	*   &paran  pInfo[out]:返回的虚拟显示器信息
	*	@return	见返回错误码
	*	@remark
	*/
	__declspec(dllexport) int GetvMonitorInfo(HANDLE handle, VMON_INFO *pInfo);

	/*
	*	销毁MonitorDevice设备
	*	@param	handle[in]:CreateMonitorDevice返回的设备句柄
	*	@return	见返回错误码
	*	@remark
	*/
	__declspec(dllexport) int DestroyMonitorDevice(HANDLE handle);

}

测试工具

SDK写完了需要验证SDK的功能是否完备,是否存在bug,所以写了个工具进行验证。
软件做成了托盘形式,运行后会在电脑右下角生成托盘,右击弹出菜单:

在这里插入图片描述

插入虚拟显示器

在这里插入图片描述
插入虚拟显示器后,我们到高级显示设置可以看到命名为DLJVMON的显示器(显示器名字可以自定义,也可以提供接口修改)。
在这里插入图片描述

拔出虚拟显示器

在这里插入图片描述

设置标准分辨率

在这里插入图片描述

设置自定义分辨率

在这里插入图片描述

后记

其他的一些接口有时间再补充测试,由于家里只有win10电脑,win7的暂时没有展现。
后续有时间再增加一些其他接口。
如需项目合作,可加微信:Magic-TP-Group

已标记关键词 清除标记
相关推荐
©️2020 CSDN 皮肤主题: 大白 设计师:CSDN官方博客 返回首页