Função GetGestureInfo (winuser.h)

Recupera uma estrutura GESTUREINFO dada uma alça para as informações de gesto.

Sintaxe

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

Parâmetros

[in] hGestureInfo

O identificador de informações de gesto.

[out] pGestureInfo

Um ponteiro para a estrutura de informações de gesto.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, use a função GetLastError .

Comentários

O membro cbSize da estrutura GESTUREINFO passada para a função deve ser definido antes que a função seja chamada. Caso contrário, as chamadas para GetLastError retornarão ERROR_INVALID_PARAMETER (87 em decimal). Se um aplicativo processar uma mensagem WM_GESTURE , ele será responsável por fechar o identificador usando CloseGestureInfoHandle. A falha ao fazer isso pode resultar em vazamentos de memória do processo.

Se a mensagem for passada para DefWindowProc ou for encaminhada usando uma das classes PostMessage ou SendMessage de funções de API, o identificador será transferido com a mensagem e não precisará ser fechado pelo aplicativo.

Exemplos

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

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

Requisitos

Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll
Conjunto de APIs	ext-ms-win-ntuser-misc-l1-2-0 (introduzido no Windows 8.1)

Confira também

Funções

Guia de programação para gestos