> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IGameInputReading::GetTouchContactCount

> 입력 판독에서 터치 표면의 접촉 수를 검색합니다.

입력 판독에서 터치 표면의 접촉 수를 검색합니다.

## 구문

```cpp theme={null}
uint32_t GetTouchContactCount(
    uint32_t surfaceIndex
);
```

### 매개변수

*surfaceIndex*   \_In\_\
형식: uint32\_t

터치 표면의 인덱스입니다. [IGameInputDevice::GetTouchSurfaceCount](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_gettouchsurfacecount.md)가 반환하는 값보다 작아야 합니다.

### 반환값

형식: uint32\_t

이 판독값에서 터치 표면의 접촉 수입니다. 판독값에 터치 데이터가 포함되어 있지 않거나 *surfaceIndex*가 유효한 표면 인덱스가 아니면 0을 반환합니다.

## 설명

이 메서드를 사용하여 [IGameInputReading::GetTouchSurfaceState](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_gettouchsurfacestate.md)에 전달하는 배열의 크기를 지정하세요. null 접촉 배열로 `GetTouchSurfaceState`를 호출해도 접촉 수가 반환됩니다. 모든 판독값에 충분한 크기의 배열을 할당하려면 [GameInputTouchSurfaceInfo](https://learn.microsoft.com/en-us/gaming/gdk/docs/reference/input/gameinput/structs/gameinputtouchsurfaceinfo)의 `maxContactCount` 멤버를 사용하세요.

터치 데이터가 포함된 판독값은 [IGameInputReading::GetInputKind](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getinputkind.md)에 `GameInputKindTouch`를 포함합니다.

> [!NOTE]
>
> 터치 지원은 장치와 플랫폼에 따라 다릅니다.

## 요구 사항

**헤더:** GameInput.h

**라이브러리:** gameinput.lib

**지원되는 플랫폼:** Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 함께 보기

[GameInput 개요](https://docs.xbox.com/ko/build/core-features/common/input/overviews/input-overview.md)\
[IGameInputReading](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputreading/igameinputreading.md)\
[IGameInputReading::GetTouchSurfaceState](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_gettouchsurfacestate.md)\
[IGameInputDevice::GetTouchSurfaceInfo](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_gettouchsurfaceinfo.md)\
[GameInputTouchContact](https://learn.microsoft.com/en-us/gaming/gdk/docs/reference/input/gameinput/structs/gameinputtouchcontact)

## 버전 기록

| 버전 | 변경 사항 |
| - | - |
| **v4** | 도입됨. |


## Related topics

- [IGameInputReading::GetTouchSurfaceState](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_gettouchsurfacestate.md)
- [IGameInputReading::GetTouchCount (사용되지 않음)](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/interfaces/igameinputreading/methods/igameinputreading_gettouchcount.md)
- [IGameInputReading::GetTouchState (사용되지 않음)](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/interfaces/igameinputreading/methods/igameinputreading_gettouchstate.md)
- [IGameInputDevice::GetTouchSurfaceCount](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_gettouchsurfacecount.md)
- [IGameInputReading::GetSystemButtonState](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getsystembuttonstate.md)