Pular para o conteúdo principal
Recupera o número de contatos em uma superfície de toque em uma leitura de entrada.

Sintaxe

Parâmetros

surfaceIndex   _In_
Tipo: uint32_t
Índice da superfície de toque. Deve ser menor que o valor retornado por IGameInputDevice::GetTouchSurfaceCount.

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. 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. As leituras que contêm dados de toque incluem GameInputKindTouch em IGameInputReading::GetInputKind.
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
IGameInputReading
IGameInputReading::GetTouchSurfaceState
IGameInputDevice::GetTouchSurfaceInfo
GameInputTouchContact

Histórico de versões

Última modificação em 6 de novembro de 2026