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 ( |