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) |