GetPointerTouchInfo 함수(winuser.h)
현재 메시지와 연결된 지정된 포인터( PT_TOUCH 형식)에 대한 터치 기반 정보를 가져옵니다.
구문
BOOL GetPointerTouchInfo(
[in] UINT32 pointerId,
[out] POINTER_TOUCH_INFO *touchInfo
);
매개 변수
[in] pointerId
정보를 검색할 포인터의 식별자입니다.
[out] touchInfo
터치 관련 포인터 정보를 수신하는 POINTER_TOUCH_INFO 구조체의 주소입니다.
반환 값
함수가 성공하면 반환 값은 0이 아닙니다.
함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.
설명
GetPointerTouchInfo 는 포인터 메시지와 연결된 단일 포인터( PT_TOUCH 형식)에 대한 정보를 검색합니다.
GetPointerFrameTouchInfo를 사용하여 포인터 집합에 대한 메시지와 연결된 프레임 정보를 검색합니다.
GetPointerTouchInfo에서 반환된 정보는 호출 스레드에서 검색한 가장 최근의 포인터 메시지와 연결됩니다. 호출 스레드에서 다음 메시지를 검색하면 이전 메시지와 연결된 정보를 더 이상 사용할 수 없습니다.
애플리케이션이 포인터 입력 메시지를 생성한 만큼 빠르게 처리하지 않으면 일부 메시지가 WM_POINTERUPDATE 메시지로 병합될 수 있습니다. GetPointerTouchInfoHistory를 사용하여 가장 최근 WM_POINTERUPDATE 메시지에서 메시지 기록을 검색합니다.
메시지와 연결된 정보를 더 이상 사용할 수 없는 경우 이 함수는 마지막 오류가 ERROR_NO_DATA 설정하여 실패합니다.
호출 스레드가 포인터 메시지가 전달된 창을 소유하지 않으면 마지막 오류가 ERROR_ACCESS_DENIED 설정되어 이 함수가 실패합니다. 입력이 원래 전달된 창이거나 메시지가 전달된 창일 수 있습니다.
지정한 포인터가 PT_TOUCH 형식이 아니면 마지막 오류가 ERROR_DATATYPE_MISMATCH 설정되어 이 함수가 실패합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 8 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2012 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | winuser.h(Windows.h 포함) |
| 라이브러리 | User32.lib |
| DLL | User32.dll |