GetGestureInfo 函数-中文整理

在给定笔势信息的句柄的情况下检索笔势信息结构。

语法

BOOL WINAPI GetGestureInfo(__in   HGESTUREINFO hGestureInfo, __out  PGESTUREINFO pGestureInfo);

参数

hGestureInfo [in]笔势信息句柄。pGestureInfo [out]一个指向笔势信息结构的指针。

返回值

如果函数成功，则返回值为非零值。如果函数失败，则返回值为零。若要获取扩展的错误信息，请使用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();                                       
    }