Qt 使用RAW INPUT获取HID触摸屏，笔设备，鼠标的原始数据，最低受支持的客户端：Windows XP [仅限桌面应用]

        在开发绘图应用程序时，经常会需要读取笔设备的数据，通过对笔数据的解析，来判断笔的坐标，粗细。如果仅仅只是读取鼠标的坐标，就需要人为在应用程序端去修改笔的粗细，并且使用体验不好，如果可以实时获取到触摸屏的笔数据的话，就可以大大提高体验感。

        获取USB-HID设备的数据，有多种方式

1. 使用Raw Input API
2. 使用Windows底层库，如Windows API，Windows HID API
3. 使用第三方库，如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具体步骤

1. 注册原始输入
2. 重写nativeEvent函数
3. 执行原始输入的标准读取

（解析截自官网）

1.注册原始输入

        为了注册设备，应用程序首先创建 一个 RAWINPUTDEVICE 结构的数组，这些结构为所需的设备指定 顶级集合 (TLC) 。 TLC 由“使用情况页”定义， (设备) 类 (设备) 。 例如，若要获取键盘 TLC，请设置 UsagePage = 0x01 和 UsageID = 0x06。 应用程序调用 RegisterRawInputDevices 来注册设备。

        请注意，应用程序可以注册当前未附加到系统的设备。 附加此设备后，Windows 管理器将自动将原始输入发送到应用程序。 若要获取系统上的原始输入设备列表，应用程序会调用 GetRawInputDeviceList。 应用程序使用此调用中的 hDevice 调用 GetRawInputDeviceInfo 以获取设备信息。

TCL:

Usage Page

HID usages are organized into usage pages of related controls. A specific control usage is defined by its usage page, a usage ID, a name, and a description. A usage page value is a 16-bit unsigned value.

Examples of usage pages include:

Expand table

Page ID	Page Name	hidusage.h constant
0x01	Generic Desktop Controls	HID_USAGE_PAGE_GENERIC
0x05	Game Controls	HID_USAGE_PAGE_GAME
0x08	LEDs	HID_USAGE_PAGE_LED
0x09	Button	HID_USAGE_PAGE_BUTTON

Usage ID

In the context of a usage page, a valid usage identifier, or usage ID, indicates a usage in a usage page. A usage ID of zero is reserved. A usage ID value is an unsigned 16-bit value.

Examples of controls that are listed on the Generic Desktop Controls usage page:

Expand table

Usage ID	Usage Name	hidusage.h constant
0x01	Pointer	HID_USAGE_GENERIC_POINTER
0x02	Mouse	HID_USAGE_GENERIC_MOUSE
0x04	Joystick	HID_USAGE_GENERIC_JOYSTICK
0x05	Game Pad	HID_USAGE_GENERIC_GAMEPAD
0x06	Keyboard	HID_USAGE_GENERIC_KEYBOARD
0x07	Keypad	HID_USAGE_GENERIC_KEYPAD
0x08	Multi-axis Controller	HID_USAGE_GENERIC_MULTI_AXIS_CONTROLLER

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;
}