구문
매개변수
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
