在给定笔势信息的句柄的情况下检索笔势信息结构。
语法
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(); }