GetPointerTouchInfoHistory 함수(winuser.h)
지정된 포인터( PT_TOUCH 형식)에 대한 현재 메시지로 병합된 개별 입력(있는 경우)과 연결된 터치 기반 정보를 가져옵니다. 가장 최근의 입력은 반환된 기록에 포함되며 GetPointerTouchInfo 함수에서 반환된 가장 최근의 입력과 동일합니다.
구문
BOOL GetPointerTouchInfoHistory(
[in] UINT32 pointerId,
[in, out] UINT32 *entriesCount,
[out, optional] POINTER_TOUCH_INFO *touchInfo
);
매개 변수
[in] pointerId
정보를 검색할 포인터의 식별자입니다.
[in, out] entriesCount
touchInfo가 가리키는 버퍼의 구조 개수를 지정하는 변수에 대한 포인터입니다. GetPointerTouchInfoHistory가 성공하면 entriesCount가 사용 가능한 총 구조체 수로 업데이트됩니다. 사용 가능한 총 구조체 수는 GetPointerInfo 또는 GetPointerTouchInfo 호출에서 반환된 POINTER_INFO 구조체의 historyCount 필드와 동일합니다.
[out, optional] touchInfo
포인터 정보를 수신할 POINTER_TOUCH_INFO 구조체 배열의 주소입니다. *entriesCount가 0인 경우 이 매개 변수는 NULL일 수 있습니다.
반환 값
함수가 성공하면 반환 값은 0이 아닙니다.
함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.
설명
애플리케이션이 포인터 입력 메시지를 생성할 때만큼 빠르게 처리하지 않으면 일부 이동이 병합될 수 있습니다. 애플리케이션이 병합 가능한 포인터( PT_TOUCH 형식) 메시지를 받으면 GetPointerTouchInfoHistory 함수를 사용하여 메시지에 병합된 모든 개별 입력(있는 경우)에 대한 정보를 검색할 수 있습니다. 검색된 정보는 호출 스레드에서 가장 최근에 검색한 포인터 메시지와 연결됩니다. 호출 스레드가 다음 메시지를 검색하면 이전 메시지와 연결된 정보를 더 이상 사용할 수 없습니다.
검색된 정보는 역순으로 나타나며 반환된 배열의 첫 번째 행에 가장 최근 항목이 있습니다. 가장 최근 항목은 GetPointerTouchInfo 함수에서 반환한 항목과 동일합니다.
제공된 버퍼의 행 수가 사용 가능한 모든 기록 항목을 보유하기에 충분하지 않은 경우 이 함수는 가장 최근 항목이 포함된 버퍼와 사용 가능한 총 항목 수를 포함하는 *entriesCount 로 성공합니다.
포인터 프레임에 지정된 포인터 외에 추가 포인터가 없으면 이 함수는 성공하고 지정된 포인터에 대한 정보만 반환합니다.
포인터 프레임과 연결된 정보를 더 이상 사용할 수 없는 경우 이 함수는 마지막 오류가 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 |