Функция GetGestureInfo (winuser.h)

Извлекает структуру GESTUREINFO , заданную дескриптором для сведений жеста.

Синтаксис

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

Параметры

[in] hGestureInfo

Дескриптор сведений о жесте.

[out] pGestureInfo

Указатель на структуру сведений о жесте.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Чтобы получить расширенные сведения об ошибке, используйте функцию GetLastError .

Комментарии

Перед вызовом функции необходимо задать элемент cbSize структуры GESTUREINFO , передаваемый в функцию. В противном случае вызовы GetLastError будут возвращать ERROR_INVALID_PARAMETER (87 в десятичном формате). Если приложение обрабатывает сообщение WM_GESTURE , оно отвечает за закрытие дескриптора с помощью CloseGestureInfoHandle. Невыполнение этого действия может привести к утечке памяти процесса.

Если сообщение передается в DefWindowProc или пересылается с помощью одного из классов PostMessage или SendMessage функций API, дескриптор передается вместе с сообщением и не должен закрываться приложением.

Примеры

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

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

Требования

См. также

Функции

Руководство по программированию жестов