GetTouchInputInfo 函数 (winuser.h)

检索有关与特定触摸输入句柄关联的触摸输入的详细信息。

语法

BOOL GetTouchInputInfo(
  [in]  HTOUCHINPUT hTouchInput,
  [in]  UINT        cInputs,
  [out] PTOUCHINPUT pInputs,
  [in]  int         cbSize
);

参数

[in] hTouchInput

在触摸消息 的 LPARAM 中收到的触摸输入句柄。 如果此句柄无效,函数将失败并 ERROR_INVALID_HANDLE 。 请注意,在成功调用 CloseTouchInputHandle 时使用句柄后,或者传递到 DefWindowProc、PostMessage、SendMessage 或其变体之一后,句柄无效。

[in] cInputs

pInputs 数组中的结构数。 理想情况下,这至少应等于消息 WPARAM 中指示的与消息关联的触摸点数。 如果 cInputs 小于触摸点数,函数仍将成功,并使用有关 cInputs 触摸点的信息填充 pInputs 缓冲区。

[out] pInputs

指向 TOUCHINPUT 结构的数组的指针,用于接收有关与指定触摸输入句柄关联的触摸点的信息。

[in] cbSize

单个 TOUCHINPUT 结构的大小(以字节为单位)。 如果 cbSize 不是单个 TOUCHINPUT 结构的大小,则函数将失败并 ERROR_INVALID_PARAMETER

返回值

如果该函数成功,则返回值为非零值。 如果函数失败,则返回值为零。 若要获取扩展错误信息,请使用 GetLastError 函数。

注解

调用 CloseTouchInputHandle 不会释放与调用 GetTouchInputInfo 中检索到的值关联的内存。 传递到 GetTouchInputInfo 的结构中的值将有效,直到删除它们。

要求

要求
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 winuser.h (包括 Windows.h)
Library User32.lib
DLL User32.dll
API 集 在 Windows 8.1) 中引入的 ext-ms-win-ntuser-misc-l1-2-0 (

另请参阅

CloseTouchInputHandle

函数

TOUCHINPUT