Función GetGestureInfo (winuser.h)
Recupera una estructura GESTUREINFO dada un identificador a la información de gestos.
Sintaxis
BOOL GetGestureInfo(
[in] HGESTUREINFO hGestureInfo,
[out] PGESTUREINFO pGestureInfo
);
Parámetros
[in] hGestureInfo
Identificador de información de gestos.
[out] pGestureInfo
Puntero a la estructura de información de gestos.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es distinto de cero.
Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, use la función GetLastError .
Comentarios
El miembro cbSize de la estructura GESTUREINFO pasada a la función debe establecerse antes de llamar a la función. De lo contrario, las llamadas a GetLastError devolverán ERROR_INVALID_PARAMETER (87 en decimal). Si una aplicación procesa un mensaje de WM_GESTURE , es responsable de cerrar el identificador mediante CloseGestureInfoHandle. Si no lo hace, es posible que se produzcan pérdidas de memoria de proceso.
Si el mensaje se pasa a DefWindowProc o se reenvía mediante una de las clases PostMessage o SendMessage de las funciones de API, el identificador se transfiere con el mensaje y la aplicación no necesita cerrarlo.
Ejemplos
GESTUREINFO gestureInfo = {0};
gestureInfo.cbSize = sizeof(gestureInfo);
BOOL bResult = GetGestureInfo((HGESTUREINFO)lParam, &gestureInfo);
if (!bResult){
DWORD err = GetLastError();
}
Requisitos
| Cliente mínimo compatible | Windows 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 R2 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | winuser.h (incluya Windows.h) |
| Library | User32.lib |
| Archivo DLL | User32.dll |
| Conjunto de API | ext-ms-win-ntuser-misc-l1-2-0 (introducido en Windows 8.1) |