메인 콘텐츠로 건너뛰기
입력 판독에서 터치 표면의 접촉을 검색합니다.

구문

매개변수

surfaceIndex   _In_
형식: uint32_t
터치 표면의 인덱스입니다. IGameInputDevice::GetTouchSurfaceCount가 반환하는 값보다 작아야 합니다. contactArrayCount   _In_
형식: uint32_t
contactArray의 요소 수입니다. contactArray   _Out_writes_to_opt_(contactArrayCount, return)
형식: GameInputTouchContact*
터치 표면의 접촉을 받는 배열입니다. null일 수 있습니다.

반환값

형식: uint32_t contactArray가 null이면 터치 표면의 접촉 수를 반환합니다. 그렇지 않으면 contactArray에 기록된 접촉 수를 반환하며, 이는 접촉 수와 contactArrayCount 중 작은 값입니다. 판독값에 터치 데이터가 포함되어 있지 않거나 surfaceIndex가 유효한 표면 인덱스가 아니면 0을 반환합니다.

설명

contactArray의 각 요소는 표면에 있는 손가락과 같은 하나의 접촉을 설명합니다. 접촉이 기록되지 않은 contactArray의 요소는 0으로 설정됩니다. GameInputTouchContact의 contactId 멤버는 접촉이 표면에 남아 있는 동안 동일하게 유지되므로, 이를 사용하여 여러 판독값에 걸쳐 접촉을 추적할 수 있습니다. contactArray의 크기를 지정하려면 IGameInputReading::GetTouchContactCount를 호출하거나, GameInputTouchSurfaceInfo의 maxContactCount 멤버를 사용하여 모든 판독값에 충분한 크기의 배열을 할당하세요. 접촉 좌표를 해석하려면 동일한 표면 인덱스로 IGameInputDevice::GetTouchSurfaceInfo를 호출하세요. 터치 데이터가 포함된 판독값은 IGameInputReading::GetInputKind에 GameInputKindTouch를 포함합니다.
터치 지원은 장치와 플랫폼에 따라 다릅니다.
다음 예제는 장치의 모든 터치 표면에서 접촉을 읽습니다.

요구 사항

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

함께 보기

GameInput 개요
IGameInputReading
IGameInputReading::GetTouchContactCount
IGameInputDevice::GetTouchSurfaceInfo
GameInputTouchContact
GameInputTouchSurfaceInfo

버전 기록

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