在开发绘图应用程序时,经常会需要读取笔设备的数据,通过对笔数据的解析,来判断笔的坐标,粗细。如果仅仅只是读取鼠标的坐标,就需要人为在应用程序端去修改笔的粗细,并且使用体验不好,如果可以实时获取到触摸屏的笔数据的话,就可以大大提高体验感。
获取USB-HID设备的数据,有多种方式
- 使用Raw Input API
- 使用Windows底层库,如Windows API,Windows HID API
- 使用第三方库,如hidapi,libusb等等
本博文主要分析Raw Input API的操作,官网解析地址:https://learn.microsoft.com/en-us/windows/win32/inputdev/about-raw-input
从官网的概述可以知道Raw Input API为应用程序提供了一种稳定而可靠的方式,可以接受来自任何 HID(包括键盘和鼠标)的原始输入。
并且具有这些优点。
Qt使用Raw Input API具体步骤
- 注册原始输入
- 重写nativeEvent函数
- 执行原始输入的标准读取
(解析截自官网)
1.注册原始输入
为了注册设备,应用程序首先创建 一个 RAWINPUTDEVICE 结构的数组,这些结构为所需的设备指定 顶级集合 (TLC) 。 TLC 由“使用情况页”定义, (设备) 类 (设备) 。 例如,若要获取键盘 TLC,请设置 UsagePage = 0x01 和 UsageID = 0x06。 应用程序调用 RegisterRawInputDevices 来注册设备。
请注意,应用程序可以注册当前未附加到系统的设备。 附加此设备后,Windows 管理器将自动将原始输入发送到应用程序。 若要获取系统上的原始输入设备列表,应用程序会调用 GetRawInputDeviceList。 应用程序使用此调用中的 hDevice 调用 GetRawInputDeviceInfo 以获取设备信息。
使用页情况:
bool Dialog::RegisitWindow(HWND hwnd)
{
if ( nullptr == hwnd ){
return FALSE;
}
RAWINPUTDEVICE rid[1];
rid[0].usUsagePage = 0x0D;
rid[0].usUsage = 0x02; // 笔设备
rid[0].dwFlags = RIDEV_INPUTSINK;
rid[0].hwndTarget = hwnd;
if (!RegisterRawInputDevices(rid, 1, sizeof(rid[0]))){
return FALSE;
}
return TRUE;
}
2.重写nativeEvent函数
bool Dialog::nativeEvent(const QByteArray &eventType, void *message, long *result)
{
}
3.执行原始输入的标准读取
应用程序从任何 HID 接收原始输入,其 顶级集合 (TLC) 与注册中的 TLC 匹配。 当应用程序收到原始输入时,其消息队列将获取 WM_INPUT 消息, 并且队列 状态标志QS_RAWINPUT设置为 (QS_INPUT 还包括此标志) 。 应用程序在前台和后台时可以接收数据。
有两种方法可以读取原始数据:无缓冲 (或标准) 方法和缓冲方法。 无缓冲区方法一次获取一个 RAWINPUT 结构的原始数据,并且足以用于许多 HID。 在这里,应用程序调用 GetMessage 以获取 WM_INPUT 消息。 然后,应用程序使用包含在 WM_INPUT 中的 RAWINPUT 句柄调用 GetRawInputData。 有关示例,请参阅 执行原始输入的标准读取。
相比之下,缓冲方法一次获取 RAWINPUT 结构的数组。 这是为可以生成大量原始输入的设备提供的。 在此方法中,应用程序调用 GetRawInputBuffer 来获取 RAWINPUT 结构的数组。 请注意, NEXTRAWINPUTBLOCK 宏用于遍历 RAWINPUT 结构的数组。 有关示例,请参阅 执行原始输入的缓冲读取。
若要解释原始输入,需要有关 HID 的详细信息。 应用程序通过使用设备句柄调用 GetRawInputDeviceInfo 来获取设备信息。 此句柄可以来自 WM_INPUT,也可以来自 RAWINPUTHEADER 的 hDevice 成员。
bool Dialog::nativeEvent(const QByteArray &eventType, void *message, long *result)
{
MSG* msg = (MSG*)message;
LPBYTE lpb;
RAWINPUT* raw;
UINT dwSize;
if(msg->message == WM_INPUT){
GetRawInputData((HRAWINPUT)msg->lParam, RID_INPUT, nullptr, &dwSize, sizeof(RAWINPUTHEADER));
lpb = new BYTE[dwSize];
if (lpb == nullptr) {
qDebug() << "内存分配失败。";
return false;
}
if (GetRawInputData((HRAWINPUT)msg->lParam, RID_INPUT, lpb, &dwSize, sizeof(RAWINPUTHEADER)) != dwSize) {
qDebug() << "GetRawInputData 返回的大小不正确!";
delete[] lpb;
return false;
}
raw = (RAWINPUT*)lpb;
if (raw->header.dwType == RIM_TYPEHID) {
qDebug() << "接收到 HID 输入。";
//在这里可以使用raw->data.hid.bRawData解析数据。
}
delete[] lpb;
}
return false;
}