GetTouchInputInfo 함수(winuser.h)

특정 터치 입력 핸들과 연결된 터치 입력에 대한 자세한 정보를 검색합니다.

구문

BOOL GetTouchInputInfo(
  [in]  HTOUCHINPUT hTouchInput,
  [in]  UINT        cInputs,
  [out] PTOUCHINPUT pInputs,
  [in]  int         cbSize
);

매개 변수

[in] hTouchInput

터치 메시지의 LPARAM 에서 받은 터치 입력 핸들입니다. 이 핸들이 유효하지 않으면 함수가 ERROR_INVALID_HANDLE 실패합니다. 핸들이 CloseTouchInputHandle 호출에 성공한 후 또는 DefWindowProc, PostMessage, SendMessage 또는 해당 변형 중 하나에 전달된 후에는 핸들이 유효하지 않습니다.

[in] cInputs

pInputs 배열의 구조체 수입니다. 이는 메시지 WPARAM에 표시된 대로 메시지와 연결된 터치 포인트 수와 적어도 같아야 합니다. cInputs가 터치 포인트 수보다 작으면 함수는 계속 성공하고 pInputs 버퍼를 cInputs 터치 포인트에 대한 정보로 채웁니다.

[out] pInputs

지정된 터치 입력 핸들과 연결된 터치 포인트에 대한 정보를 수신하는 TOUCHINPUT 구조체 배열에 대한 포인터입니다.

[in] cbSize

단일 TOUCHINPUT 구조체의 크기(바이트)입니다. cbSize가 단일 TOUCHINPUT 구조체의 크기가 아닌 경우 함수는 ERROR_INVALID_PARAMETER 함께 실패합니다.

반환 값

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

설명

CloseTouchInputHandle을 호출하면 GetTouchInputInfo 호출에서 검색된 값과 관련된 메모리가 해제되지 않습니다. GetTouchInputInfo에 전달된 구조체의 값은 삭제할 때까지 유효합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	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 도입)

추가 정보

CloseTouchInputHandle

함수

TOUCHINPUT