GetGestureInfo function

最新推荐文章于 2025-03-25 11:42:16 发布

Augusdi

最新推荐文章于 2025-03-25 11:42:16 发布

阅读量2k

点赞数

分类专栏： Windows Touch

Windows Touch 专栏收录该内容

55 篇文章

订阅专栏

本文详细介绍了GetGestureInfo API的功能及使用方法，该API用于通过手势信息句柄检索GESTUREINFO结构。文章提供了参数说明、返回值解释及注意事项，并附带了示例代码。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Retrieves a GESTUREINFO structure given a handle to the gesture information.

Syntax

    BOOL WINAPI GetGestureInfo(_In_   HGESTUREINFO hGestureInfo, _Out_  PGESTUREINFO pGestureInfo);

Parameters

hGestureInfo [in]

The gesture information handle.

pGestureInfo [out]

A pointer to the gesture information structure.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, use the GetLastError function.

Remarks

The cbSize member of the GESTUREINFO structure passed in to the function must be set before the function is called. Otherwise, calls to GetLastError will return ERROR_INVALID_PARAMETER (87 in decimal). If an application processes a WM_GESTURE message, it is responsible for closing the handle using CloseGestureInfoHandle. Failure to do so may result in process memory leaks.

If the message is passed to DefWindowProc, or is forwarded using one of the PostMessage or SendMessage classes of API functions, the handle is transferred with the message and need not be closed by the application.

Examples

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

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

Requirements

Minimum supported client	Windows 7 [desktop apps only]
Minimum supported server	Windows Server 2008 R2 [desktop apps only]
Header	Winuser.h (include Windows.h)
Library	User32.lib
DLL	User32.dll