WindowsAPI-C#版_原始设备输入常用API：
/**
*┌──────────────────────────────────────────────────────────────┐
*│ 描 述：WindowsAPI_键鼠、游戏杆、触摸屏和麦克风等输入设备
*│ 作 者：执笔小白
*│ 版 本：1.0
*│ 创建时间：2022-11-13 15:40:56
*└──────────────────────────────────────────────────────────────┘
*┌──────────────────────────────────────────────────────────────┐
*│ 命名空间: WindowAPIHelper.API
*│ 类 名：WindowsAPI_KeyboardAndMouseInput
*└──────────────────────────────────────────────────────────────┘
*/
using System;
using System.Collections.Generic;
using System.Data;
using System.Linq;
using System.Runtime.InteropServices;
using System.Text;
using System.Threading.Tasks;
namespace WindowAPIHelper.API
{
/// <summary>
/// WindowsAPI_键鼠、游戏杆、触摸屏和麦克风等输入设备
/// </summary>
public class WindowsAPI_KeyboardAndMouseInput
{
#region 常用
/// <summary>
/// 注册提供原始输入数据的设备
/// 若要接收 WM_INPUT 消息，应用程序必须先使用 RegisterRawInputDevices 注册原始输入设备。 默认情况下，应用程序不会接收原始输入。
/// </summary>
/// <param name="pRawInputDevice">表示提供原始输入的设备，RAWINPUTDEVICE[]数组</param>
/// <param name="uiNumDevices">pRawInputDevices 指向的 RAWINPUTDEVICE 结构数。</param>
/// <param name="cbSize">RAWINPUTDEVICE 结构的大小（以字节为单位）</param>
/// <returns>如果函数成功，则为 TRUE;否则为 FALSE。 如果函数失败，请调用 GetLastError 以获取详细信息。</returns>
[DllImport("User32.dll")]
public extern static bool RegisterRawInputDevices(RAWINPUTDEVICE[] pRawInputDevice, uint uiNumDevices, uint cbSize);
/// <summary>
/// 检索有关原始输入设备的信息
/// </summary>
/// <param name="hDevice">原始输入设备的句柄</param>
/// <param name="uiCommand">指定将在 pData 中返回哪些数据 (uint)</param>
/// <param name="pData">指向包含 uiCommand 指定的信息的缓冲区的指针(如果 uiCommandRIDI_DEVICEINFO，请将RID_DEVICE_INFO的cbSize 成员设置为sizeof(RID_DEVICE_INFO)调用 GetRawInputDeviceInfo 之前。)</param>
/// <param name="pcbSize">如果成功，此函数将返回一个非负数，指示复制到 pData 的字节数。如果 pData 不足以容纳数据，则函数返回 -1。 如果 pData 为 NULL，则函数返回值为零。</param>
/// <returns></returns>
[DllImport("User32.dll")]
public extern static uint GetRawInputDeviceInfo(IntPtr hDevice, UiCommand uiCommand, IntPtr pData, ref uint pcbSize);
/// <summary>
/// 从指定设备检索原始输入
/// </summary>
/// <param name="hRawInput">句柄</param>
/// <param name="uiCommand">指定将在 pData 中返回哪些数据 (uint)</param>
/// <param name="pData">指向 来自 RAWINPUT 结构的数据的指针。 这取决于 uiCommand 的值。 如果 pData 为 NULL，则缓冲区的所需大小在 *mbSize 中返回。</param>
/// <param name="pcbSize">pData 中数据的大小（以字节为单位）。</param>
/// <param name="cbSizeHeader">RAWINPUTHEADER 结构的大小（以字节为单位）。</param>
/// <returns></returns>
[DllImport("User32.dll")]
public extern static uint GetRawInputData(IntPtr hRawInput, UiCommand uiCommand, IntPtr pData, ref uint pcbSize, uint cbSizeHeader);
/// <summary>
/// 从指定设备检索原始输入数据组
/// </summary>
/// <param name="pData">指向 来自 RAWINPUT 结构的数据的指针。 这取决于 uiCommand 的值。 如果 pData 为 NULL，则缓冲区的所需大小在 *mbSize 中返回。</param>
/// <param name="pcbSize">pData 中数据的大小（以字节为单位）。</param>
/// <param name="cbSizeHeader">RAWINPUTHEADER 结构的大小（以字节为单位）。</param>
/// <returns></returns>
[DllImport("User32.dll")]
public extern static uint GetRawInputBuffer(IntPtr pData, ref uint pcbSize, uint cbSizeHeader);
// tagRAWINPUTHEADER（包含原始输入数据的一部分的标头信息） 略：可以使用GetRawInputData
// RAWINPUT函数（原始输入） 略：可以使用GetRawInputData
#endregion 常用
#region 枚举、结构等数据类型
/// <summary>
/// 指定将在 pData 中返回哪些数据 (uint)
/// </summary>
public enum UiCommand
{
#region getRawInputData 函数(从指定设备检索原始输入)
RID_INPUT = 0x10000003, // 从 RAWINPUT 结构获取标头信息。
RID_HEADER = 0x10000005, // 从 RAWINPUT 结构获取原始数据。
#endregion getRawInputData 函数
#region GetRawInputDeviceInfo 函数(检索有关原始输入设备的信息)
RIDI_PREPARSEDDATA = 0x20000005, // pData 指向 顶级集合预分析数据的缓冲区的PHIDP_PREPARSED_DATA指针。
RIDI_DEVICENAME = 0x20000007, // pData 指向包含 设备接口名称的字符串。
RIDI_DEVICEINFO = 0x2000000b, // pData 指向 RID_DEVICE_INFO结构。
#endregion GetRawInputDeviceInfo 函数
}
/// <summary>
/// RAWINPUTDEVICE(原始输入设备的信息_与存储设备信息有关联的信息)
/// </summary>
[StructLayout(LayoutKind.Sequential)]
public struct RAWINPUTDEVICE
{
/// <summary>
/// 原始输入设备的顶级集合使用情况页。
/// </summary>
[MarshalAs(UnmanagedType.U2)]
public ushort usUsagePage;
/// <summary>
/// 原始输入设备的顶级集合使用情况 ID
/// </summary>
[MarshalAs(UnmanagedType.U2)]
public ushort usUsage;
/// <summary>
/// 指定如何解释 usUsagePage 和 usUsage 提供的信息的模式标志。
/// 默认情况下，只要具有窗口焦点，操作系统就会从具有指定 顶级集合 的设备发送原始输入， (TLC) 到已注册的应用程序。
/// </summary>
[MarshalAs(UnmanagedType.U4)]
public DwFlags dwFlags;
/// <summary>
/// 目标窗口的句柄。 如果 为 NULL ，则它遵循键盘焦点。
/// </summary>
public IntPtr hwndTarget;
}
/// <summary>
/// 原始输入设备的信息_设备有关的信息
/// </summary>
[StructLayout(LayoutKind.Sequential)]
public struct RAWINPUTHEADER
{
/// <summary>
/// 输入设备的类型（鼠标、键盘、不是键盘或鼠标的某些设备）
/// </summary>
[MarshalAs(UnmanagedType.U4)]
public DwType dwType; // 输入设备的类型（鼠标、键盘、不是键盘或鼠标的某些设备）
/// <summary>
/// 整个输入数据包的大小（以字节为单位）。 这包括 RAWINPUT 加上 RAWHID 可变长度数组中可能的额外输入报告。
/// </summary>
[MarshalAs(UnmanagedType.U4)]
public int dwSize; // 整个输入数据包的大小（以字节为单位）。 这包括 RAWINPUT 加上 RAWHID 可变长度数组中可能的额外输入报告。
/// <summary>
/// 生成原始输入数据的设备的句柄。
/// </summary>
public IntPtr hDevice; // 生成原始输入数据的设备的句柄。
/// <summary>
/// 在WM_INPUT消息的 wParam 参数中传递的值。
/// </summary>
[MarshalAs(UnmanagedType.U4)]
public int wParam; // 在WM_INPUT消息的 wParam 参数中传递的值。
}
/// <summary>
/// 原始输入信息的结构
/// </summary>
[StructLayout(LayoutKind.Explicit)]
public struct RAWINPUT
{
/// <summary>
/// 标头信息
/// </summary>
[FieldOffset(0)]
public RAWINPUTHEADER header;
/// <summary>
/// 鼠标信息
/// </summary>
[FieldOffset(16)]
public RAWMOUSE mouse;
/// <summary>
/// 键盘信息
/// </summary>
[FieldOffset(16)]
public RAWKEYBOARD keyboard;
/// <summary>
/// 不是键盘或鼠标的某些设备
/// </summary>
[FieldOffset(16)]
public RAWHID hid;
}
#region 定义来自任何设备的原始输入数据
/// <summary>
/// 定义来自任何设备的原始输入数据
/// </summary>
[StructLayout(LayoutKind.Explicit)]
public struct RID_DEVICE_INFO
{
/// <summary>
/// RID_DEVICE_INFO结构的大小（以字节为单位）
/// </summary>
[FieldOffset(0)]
public int cbSize;
/// <summary>
/// 原始输入数据的类型
/// </summary>
[FieldOffset(4)]
public DwType dwType;
/// <summary>
/// 定义鼠标 的RID_DEVICE_INFO_MOUSE 结构；dwType=RIM_TYPEMOUSE时有值
/// </summary>
[FieldOffset(8)]
public RID_DEVICE_INFO_MOUSE mouse;
/// <summary>
/// 定义键盘 的RID_DEVICE_INFO_KEYBOARD 结构；dwType=RIM_TYPEKEYBOARD时有值
/// </summary>
[FieldOffset(8)]
public RID_DEVICE_INFO_KEYBOARD keyboard;
/// <summary>
/// 定义 HID 设备的 RID_DEVICE_INFO_HID 结构；dwType=RIM_TYPEHID时有值
/// </summary>
[FieldOffset(8)]
public RID_DEVICE_INFO_HID hid;
}
/// <summary>
/// 定义来自指定鼠标的原始输入数据(备注，对于鼠标，“使用情况”页为 1，使用情况为 2)
/// </summary>
[StructLayout(LayoutKind.Sequential)]
public struct RID_DEVICE_INFO_MOUSE
{
/// <summary>
/// 鼠标设备标识属性的位字段
/// </summary>
[MarshalAs(UnmanagedType.U4)]
public DwId dwId;
/// <summary>
/// 鼠标的按钮数
/// </summary>
[MarshalAs(UnmanagedType.U4)]
public int dwNumberOfButtons;
/// <summary>
/// 每秒数据点数。 此信息可能不适用于每个鼠标设备。
/// </summary>
[MarshalAs(UnmanagedType.U4)]
public int dwSampleRate;
/// <summary>
/// 如果鼠标具有用于水平滚动的滚轮，则为 TRUE;否则为 FALSE。Windowsxp： 仅从 Windows Vista 开始支持此成员。
/// </summary>
[MarshalAs(UnmanagedType.U4)]
public int fHasHorizontalWheel; // true存为int，用bool可能有bug
}
/// <summary>
/// 定义来自指定键盘的原始输入数据
/// </summary>
[StructLayout(LayoutKind.Sequential)]
public struct RID_DEVICE_INFO_KEYBOARD
{
/// <summary>
/// 键盘的类型
/// </summary>
[MarshalAs(UnmanagedType.U4)]
public DwType dwType;
/// <summary>
/// 键盘的特定于供应商的子类型
/// </summary>
[MarshalAs(UnmanagedType.U4)]
public int dwSubType;
/// <summary>
/// 扫描代码模式。通常为1，这意味着使用“扫描代码集1”
/// </summary>
[MarshalAs(UnmanagedType.U4)]
public int dwKeyboardMode;
/// <summary>
/// 键盘上的函数键数
/// </summary>
[MarshalAs(UnmanagedType.U4)]
public int dwNumberOfFunctionKeys;
/// <summary>
/// 键盘上的 LED 指示器数
/// </summary>
[MarshalAs(UnmanagedType.U4)]
public int dwNumberOfIndicators;
/// <summary>
/// 键盘上的键总数
/// </summary>
[MarshalAs(UnmanagedType.U4)]
public int dwNumberOfKeysTotal;
}
/// <summary>
/// 定义来自指定人机接口设备 (HID) 的原始输入数据
/// </summary>
[StructLayout(LayoutKind.Sequential)]
public struct RID_DEVICE_INFO_HID
{
/// <summary>
/// HID 的供应商标识符
/// </summary>
[MarshalAs(UnmanagedType.U4)]
public int dwVendorId;
/// <summary>
/// HID 的产品标识符
/// </summary>
[MarshalAs(UnmanagedType.U4)]
public int dwProductId;
/// <summary>
/// HID 的版本号
/// </summary>
[MarshalAs(UnmanagedType.U4)]
public int dwVersionNumber;
/// <summary>
/// 设备的顶级集合使用情况页
/// </summary>
[MarshalAs(UnmanagedType.U2)]
public ushort usUsagePage;
/// <summary>
/// 设备的顶级集合使用情况
/// </summary>
[MarshalAs(UnmanagedType.U2)]
public ushort usUsage;
}
#endregion 定义来自任何设备的原始输入数据
#region 原始输入信息的结构
/// <summary>
/// 原始输入来自鼠标信息
/// </summary>
[StructLayout(LayoutKind.Explicit)]
public struct RAWMOUSE
{
/// <summary>
/// 设置获取鼠标的相对移动还是绝对移动
/// </summary>
[MarshalAs(UnmanagedType.U2)]
[FieldOffset(0)]
public UsFlags usFlags;
#region DUMMYUNIONNAME 结构
/// <summary>
/// 按钮标识
/// </summary>
[MarshalAs(UnmanagedType.U4)]
[FieldOffset(4)]
public ulong ulButtons;
/// <summary>
/// 按钮信息
/// </summary>
[FieldOffset(4)]
public DUMMYSTRUCTNAME buttonsStr;
#endregion DUMMYUNIONNAME 结构
/// <summary>
/// 鼠标按钮的原始状态。Win32子系统不使用此成员。
/// </summary>
[MarshalAs(UnmanagedType.U4)]
[FieldOffset(8)]
public ulong ulRawButtons;
/// <summary>
/// X方向的运动。相对运动或绝对运动取决于usFlags的值。
/// </summary>
[FieldOffset(12)]
public long lLastX;
/// <summary>
/// Y方向的运动。相对运动或绝对运动取决于usFlags的值。
/// </summary>
[FieldOffset(16)]
public long lLastY;
/// <summary>
/// 事件设备的特定附加信息。
/// </summary>
[MarshalAs(UnmanagedType.U4)]
[FieldOffset(20)]
public ulong ulExtraInformation;
}
/// <summary>
/// 原始输入来自键盘信息
/// </summary>
[StructLayout(LayoutKind.Sequential)]
public struct RAWKEYBOARD
{
/// <summary>
/// 指定与按键关联的扫描代码。见博客补充-键值Key
/// </summary>
[MarshalAs(UnmanagedType.U2)]
public ushort MakeCode;
/// <summary>
/// 扫描代码信息的标志
/// </summary>
[MarshalAs(UnmanagedType.U2)]
public RAWKEYBOARD_Flags Flags;
/// <summary>
/// 保留;必须为零
/// </summary>
[MarshalAs(UnmanagedType.U2)]
public ushort Reserved;
/// <summary>
/// 相应的 旧虚拟密钥代码
/// </summary>
[MarshalAs(UnmanagedType.U2)]
public ushort VKey;
/// <summary>
/// 相应的 旧式键盘窗口消息，例如 WM_KEYDOWN、 WM_SYSKEYDOWN等
/// </summary>
[MarshalAs(UnmanagedType.U4)]
public uint Message;
/// <summary>
/// 事件特定于设备的其他信息
/// </summary>
[MarshalAs(UnmanagedType.U4)]
public ulong ExtraInformation;
}
/// <summary>
/// 原始输入来自不是键盘或鼠标的某些设备
/// </summary>
[StructLayout(LayoutKind.Sequential)]
public struct RAWHID
{
/// <summary>
/// bRawData中每个HID输入的大小（以字节为单位）。
/// </summary>
[MarshalAs(UnmanagedType.U4)]
public int dwSizHid;
/// <summary>
/// bRawData中HID输入的数量。
/// </summary>
[MarshalAs(UnmanagedType.U4)]
public int dwCount;
/// <summary>
/// 原始输入数据，作为字节数组。
/// </summary>
[MarshalAs(UnmanagedType.U4)]
public byte bRawData;
}
#endregion 原始输入信息的结构
/// <summary>
/// WM_INPUT：输入设备的类型（鼠标、键盘、不是键盘或鼠标的某些设备）
/// 输入设备的类型（再细分类型）
/// </summary>
public enum DwType
{
#region 原始输入来自哪个设备
/// <summary>
/// 原始输入来自鼠标
/// </summary>
RIM_TYPEMOUSE = 0, // 原始输入来自鼠标
/// <summary>
/// 原始输入来自键盘
/// </summary>
RIM_TYPEKEYBOARD = 1, // 原始输入来自键盘
/// <summary>
/// 原始输入来自不是键盘或鼠标的某些设备
/// </summary>
RIM_TYPEHID = 2, // 原始输入来自不是键盘或鼠标的某些设备
#endregion 原始输入来自哪个设备
#region 键盘类型
增强型101或102键键盘 = 0x4,
日语键盘 = 0x7,
朝鲜语键盘 = 0x8,
未知类型或HID键盘= 0x51
#endregion 键盘类型
}
/// <summary>
/// 指定如何解释 usUsagePage 和 usUsage 提供的信息的模式标志。
/// </summary>
public enum DwFlags
{
Default = 0x00000000, // 默认
RIDEV_REMOVE = 0x00000001, // 从包含列表中删除顶级集合。 这会告知操作系统停止从与顶级集合匹配的设备读取。
RIDEV_EXCLUDE = 0x00000010, // 指定读取完整使用情况页时要排除的顶级集合。 此标志仅影响已使用 RIDEV_PAGEONLY 指定的 TLC。
RIDEV_PAGEONLY = 0x00000020, // 指定其顶级集合来自指定 usUsagePage 的所有设备。 请注意， usUsage 必须为零。 若要排除特定的顶级集合，请使用 RIDEV_EXCLUDE。
RIDEV_NOLEGACY = 0x00000030, // 阻止 usUsagePage 或 usUsage 指定的任何设备生成 旧消息。 这仅适用于鼠标和键盘。
RIDEV_INPUTSINK = 0x00000100, // 如果已设置，则即使调用方不在前台，调用方也能够接收输入。 请注意，必须指定 hwndTarget 。
RIDEV_CAPTUREMOUSE = 0x00000200, // 鼠标按钮单击不会激活另一个窗口。 仅当为鼠标设备指定了RIDEV_NOLEGACY时，才能指定RIDEV_CAPTUREMOUSE。
RIDEV_NOHOTKEYS = 0x00000200, // 不会处理应用程序定义的键盘设备热键。 但是，系统热键;例如，仍处理 Alt+TAB 和 Ctrl+ALT+DEL。 默认情况下，将处理所有键盘热键。 即使未指定RIDEV_NOLEGACY且 hwndTarget 为 NULL，也可以指定RIDEV_NOHOTKEYS。
RIDEV_APPKEYS = 0x00000400, // 处理应用程序命令密钥。 仅当为键盘设备指定了RIDEV_NOLEGACY时，才能指定RIDEV_APPKEYS。
RIDEV_EXINPUTSINK = 0x00001000, // 仅当前台应用程序未处理它时，调用方才能在后台接收输入。 换句话说，如果未为原始输入注册前台应用程序，则注册的后台应用程序将收到输入。在 Windows Vista 之前不支持此标志
RIDEV_DEVNOTIFY = 0x00002000 // 允许调用方接收设备到达和设备删除 WM_INPUT_DEVICE_CHANGE 通知。在 Windows Vista 之前不支持此标志
}
#region 鼠标原始输入有关类型
/// <summary>
/// 设置获取鼠标的相对移动还是绝对移动
/// </summary>
public enum UsFlags
{
MOUSE_MOVE_RELATIVE = 0x00, // 相对于最后一个鼠标位置的鼠标移动数据。
MOUSE_MOVE_ABSOLUTE = 0x01, // 基于绝对位置的鼠标移动数据。
MOUSE_VIRTUAL_DESKTOP = 0x02, // 鼠标坐标映射到虚拟桌面（对于多监视器系统）。
MOUSE_ATTRIBUTES_CHANGED = 0x04, // 鼠标属性已更改；应用程序需要查询鼠标属性。
MOUSE_MOVE_NOCOALESCE = 0x08, // 此鼠标移动事件未合并。默认情况下，可以合并鼠标移动事件。Windows XP/2000:不支持此值。
}
/// <summary>
/// 标识按钮触发事件(标识了哪个键发生了什么事件)
/// </summary>
public enum UsButtonFlags
{
RI_MOUSE_BUTTON_1_DOWN = 0x0001, // RI_MOUSE_LEFT_BUTTON_DOWN
RI_MOUSE_BUTTON_1_UP = 0x0002, // RI_MOUSE_LEFT_BUTTON_UP
RI_MOUSE_BUTTON_2_DOWN = 0x0004, // RI_MOUSE_RIGHT_BUTTON_DOWN
RI_MOUSE_BUTTON_2_UP = 0x0008, // RI_MOUSE_RIGHT_BUTTON_UP
RI_MOUSE_BUTTON_3_DOWN = 0x0010, // RI_MOUSE_MIDDLE_BUTTON_DOWN
RI_MOUSE_BUTTON_3_UP = 0x0020, // RI_MOUSE_MIDDLE_BUTTON_UP
RI_MOUSE_BUTTON_4_DOWN = 0x0040, // X_BUTTON1 changed to down.
RI_MOUSE_BUTTON_4_UP = 0x0080, // X_BUTTON1 changed to up.
RI_MOUSE_BUTTON_5_DOWN = 0x0100, // X_BUTTON2 changed to down.
RI_MOUSE_BUTTON_5_UP = 0x0200, // X_BUTTON2 changed to up.
RI_MOUSE_WHEEL = 0x0400, // 鼠标滚轮，值存储在inusButtonData中；正值表示车轮向前滚动，远离用户；负值表示车轮向后滚动。
RI_MOUSE_HWHEEL = 0x0800, // 鼠标水平滚轮，值存储在inusButtonData中；正值表示车轮向右旋转；负值表示车轮向左旋转。
}
#endregion 鼠标原始输入有关类型
#region 键盘原始输入有关类型
/// <summary>
/// 按键扫描代码信息的标志
/// </summary>
public enum RAWKEYBOARD_Flags
{
RI_KEY_MAKE = 0, // 密钥关闭
RI_KEY_BREAK = 1, // 密钥已启动
RI_KEY_E0 = 2, // 扫描代码具有 E0 前缀
RI_KEY_E1 = 4, // 扫描代码具有 E1 前缀
}
#endregion 键盘原始输入有关类型
/// <summary>
/// 按钮信息
/// </summary>
[StructLayout(LayoutKind.Sequential)]
public struct DUMMYSTRUCTNAME
{
/// <summary>
/// 标识按钮触发事件(标识了哪个键发生了什么事件)
/// </summary>
[MarshalAs(UnmanagedType.U2)]
public UsButtonFlags usButtonFlags;
/// <summary>
/// 按钮事件信息数据
/// </summary>
[MarshalAs(UnmanagedType.U2)]
public ushort usButtonData;
}
/// <summary>
/// 鼠标设备标识属性的位字段
/// </summary>
public enum DwId
{
MOUSE_HID_HARDWARE = 0x0080, // HID 鼠标
WHEELMOUSE_HID_HARDWARE = 0x0100, // HID 滚轮鼠标
HORIZONTAL_WHEEL_PRESENT = 0x8000, // 带有水平滚轮的鼠标
}
#endregion 枚举、结构等数据类型
}
}标签：鼠标,UnmanagedType,C#,键盘,API,MarshalAs,public,输入,WindowsAPI From： https://www.cnblogs.com/qq2806933146xiaobai/p/16944220.html