getGestureInfo 函数 (winuser.h)

  • 项目

检索给定手势信息的句柄的 GESTUREINFO 结构。

语法

BOOL GetGestureInfo(
  [in]  HGESTUREINFO hGestureInfo,
  [out] PGESTUREINFO pGestureInfo
);

参数

[in] hGestureInfo

手势信息句柄。

[out] pGestureInfo

指向手势信息结构的指针。

返回值

如果该函数成功，则返回值为非零值。

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

注解

在调用函数之前，必须设置传递给函数的 GESTUREINFO 结构的 cbSize 成员。 否则，调用 GetLastError 将返回十进制 ) ERROR_INVALID_PARAMETER (87。 如果应用程序处理 WM_GESTURE 消息，则它负责使用 CloseGestureInfoHandle 关闭句柄。 否则可能会导致进程内存泄漏。

如果消息传递到 DefWindowProc，或使用 API 函数的 PostMessage 或 SendMessage 类之一转发，则句柄随消息一起传输，并且不需要由应用程序关闭。

示例


    GESTUREINFO gestureInfo = {0};
    gestureInfo.cbSize = sizeof(gestureInfo);
    BOOL bResult = GetGestureInfo((HGESTUREINFO)lParam, &gestureInfo);

    if (!bResult){                
        DWORD err = GetLastError();                                       
    }

要求

   
最低受支持的客户端 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 (

请参阅

函数

手势编程指南