메인 콘텐츠로 건너뛰기
입력 장치의 터치 표면에 대한 정보를 가져옵니다.

구문

매개변수

surfaceIndex
형식: uint32_t
터치 표면의 0부터 시작하는 인덱스입니다. IGameInputDevice::GetTouchSurfaceCount가 반환하는 값보다 작아야 합니다. info   _Out_
형식: GameInputTouchSurfaceInfo*
터치 표면에 대한 정보를 받습니다.

반환값

형식: HRESULT 성공하면 S_OK를 반환합니다. surfaceIndex가 장치의 터치 표면 수보다 크거나 같으면 E_BOUNDS를 반환하며, 이 경우 info는 0으로 채워집니다.

설명

반환된 정보는 표면이 보고할 수 있는 최대 동시 접촉 수, 장치 단위로 나타낸 표면의 크기, 터치패드나 터치스크린과 같은 표면의 유형을 설명합니다. IGameInputReading::GetTouchSurfaceState가 보고하는 접촉 위치는 이 크기를 기준으로 하므로, 이를 사용하여 접촉 위치를 정규화할 수 있습니다. 이 정보는 장치 개체의 수명 동안 변경되지 않습니다. 다음 예제는 장치의 각 터치 표면에서 첫 번째 접촉의 위치를 [0, 1) 범위로 정규화합니다.
터치 지원은 장치와 플랫폼에 따라 다릅니다.

요구 사항

헤더: GameInput.h 라이브러리: gameinput.lib 지원되는 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

함께 보기

GameInput 개요
IGameInputDevice
GameInputTouchSurfaceInfo
IGameInputDevice::GetTouchSurfaceCount
IGameInputReading::GetTouchSurfaceState

버전 기록

마지막 수정일 2026년 11월 6일