> ## 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

> Recupera o número de contatos em uma superfície de toque em uma leitura de entrada.

Recupera o número de contatos em uma superfície de toque em uma leitura de entrada.

## Sintaxe

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

### Parâmetros

*surfaceIndex*   \_In\_\
Tipo: uint32\_t

Índice da superfície de toque. Deve ser menor que o valor retornado por [IGameInputDevice::GetTouchSurfaceCount](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_gettouchsurfacecount.md).

### Valor retornado

Tipo: uint32\_t

O número de contatos na superfície de toque nesta leitura. Retorna 0 se a leitura não contiver dados de toque ou se *surfaceIndex* não for um índice de superfície válido.

## Comentários

Use este método para dimensionar a matriz passada para [IGameInputReading::GetTouchSurfaceState](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_gettouchsurfacestate.md). Chamar `GetTouchSurfaceState` com uma matriz de contatos nula também retorna o número de contatos. Para alocar uma matriz grande o suficiente para qualquer leitura, use o membro `maxContactCount` de [GameInputTouchSurfaceInfo](https://learn.microsoft.com/en-us/gaming/gdk/docs/reference/input/gameinput/structs/gameinputtouchsurfaceinfo).

As leituras que contêm dados de toque incluem `GameInputKindTouch` em [IGameInputReading::GetInputKind](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getinputkind.md).

> [!NOTE]
>
> O suporte ao toque depende do dispositivo e da plataforma.

## Requisitos

**Cabeçalho:** GameInput.h

**Biblioteca:** gameinput.lib

**Plataformas com suporte:** Windows, consoles da família XBOX One e consoles XBOX Series

## Confira também

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

## Histórico de versões

| Versão | Alterações |
| - | - |
| **v4** | Introduzido. |


## Related topics

- [IGameInputReading::GetTouchSurfaceState](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_gettouchsurfacestate.md)
- [IGameInputReading::GetTouchCount (Preterido)](https://docs.xbox.com/pt-BR/reference/input/gameinput/deprecated/interfaces/igameinputreading/methods/igameinputreading_gettouchcount.md)
- [IGameInputReading::GetTouchState (Preterido)](https://docs.xbox.com/pt-BR/reference/input/gameinput/deprecated/interfaces/igameinputreading/methods/igameinputreading_gettouchstate.md)
- [IGameInputDevice::GetTouchSurfaceCount](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_gettouchsurfacecount.md)
- [IGameInputReading::GetMotionState (Preterido)](https://docs.xbox.com/pt-BR/reference/input/gameinput/deprecated/interfaces/igameinputreading/methods/igameinputreading_getmotionstate.md)