getRawInputData 函数 (winuser.h)

  • 项目

从指定设备检索原始输入。

语法

UINT GetRawInputData(
  [in]            HRAWINPUT hRawInput,
  [in]            UINT      uiCommand,
  [out, optional] LPVOID    pData,
  [in, out]       PUINT     pcbSize,
  [in]            UINT      cbSizeHeader
);

参数

[in] hRawInput

类型： HRAWINPUT

RAWINPUT 结构的句柄。 这来自 WM_INPUT 中的 lParam。

[in] uiCommand

类型： UINT

命令标志。 此参数的取值可为下列值之一：

值 含义
RID_HEADER
0x10000005
 从 RAWINPUT 结构获取标头信息。
RID_INPUT
0x10000003
 从 RAWINPUT 结构获取原始数据。

[out, optional] pData

类型： LPVOID

指向来自 RAWINPUT 结构的数据的指针。 这取决于 uiCommand 的值。 如果 pData 为 NULL，则会在 *pcSize 中返回所需的缓冲区大小。

[in, out] pcbSize

类型： PUINT

pData 中数据的大小（以字节为单位）。

[in] cbSizeHeader

类型： UINT

RAWINPUTHEADER 结构的大小（以字节为单位）。

返回值

类型： UINT

如果 pData 为 NULL 且函数成功，则返回值为 0。 如果 pData 不为 NULL 且函数成功，则返回值是复制到 pData 中的字节数。

如果出现错误，则返回值为 UINT () -1。

注解

GetRawInputData 一次获取一个 RAWINPUT 结构的原始输入。 相比之下， GetRawInputBuffer 获取 RAWINPUT 结构的数组。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 winuser.h (包括 Windows.h)
Library User32.lib
DLL User32.dll
API 集 在 Windows 10 版本 10.0.14393 中引入的 ext-ms-win-ntuser-rawinput-l1-1-0 ()

请参阅

概念性

GetRawInputBuffer

RAWINPUT

RAWINPUTHEADER

原始输入

引用