GetGestureInfo 함수(winuser.h)

제스처 정보에 대한 핸들이 지정된 GESTUREINFO 구조를 검색합니다.

구문

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

매개 변수

[in] hGestureInfo

제스처 정보 핸들입니다.

[out] pGestureInfo

제스처 정보 구조에 대한 포인터입니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장된 오류 정보를 얻으려면 GetLastError 함수를 사용합니다.

설명

함수에 전달된 GESTUREINFO 구조체의 cbSize 멤버는 함수가 호출되기 전에 설정해야 합니다. 그렇지 않으면 GetLastError 에 대한 호출은 ERROR_INVALID_PARAMETER (10진수 87)를 반환합니다. 애플리케이션이 WM_GESTURE 메시지를 처리하는 경우 CloseGestureInfoHandle을 사용하여 핸들을 닫습니다. 이렇게 하지 않으면 프로세스 메모리 누수가 발생할 수 있습니다.

메시지가 DefWindowProc에 전달되거나 API 함수의 PostMessage 또는 SendMessage 클래스 중 하나를 사용하여 전달되는 경우 핸들은 메시지와 함께 전송되며 애플리케이션에서 닫을 필요가 없습니다.

예제

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

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

요구 사항

지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll
API 세트	ext-ms-win-ntuser-misc-l1-2-0(Windows 8.1 도입)

참조

함수

제스처에 대한 프로그래밍 가이드