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

命令标志。 此参数可以是下列值之一。

[out, optional] pData

类型：LPVOID

指向来自 RAWINPUT 结构的数据的指针。 这取决于 uiCommand 的值。 指针应在 DWORD （32 位）边界上对齐。

如果 pData 为 NULL，则缓冲区的所需大小在 *mbSize 中返回。

[in, out] pcbSize

类型： PUINT

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

[in] cbSizeHeader

类型：UINT

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

返回值

类型：UINT

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

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

注解

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

要求

另请参阅

概念

GetRawInputBuffer

RAWINPUT

RAWINPUTHEADER

原始输入

引用