Pular para o conteúdo principal
Recupera os contatos em uma superfície de toque de 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. contactArrayCount   _In_
Tipo: uint32_t
Número de elementos em contactArray. contactArray   _Out_writes_to_opt_(contactArrayCount, return)
Tipo: GameInputTouchContact*
Matriz que recebe os contatos na superfície de toque. Pode ser nula.

Valor retornado

Tipo: uint32_t Se contactArray for nulo, retorna o número de contatos na superfície de toque. Caso contrário, retorna o número de contatos gravados em contactArray, que é o menor valor entre o número de contatos e contactArrayCount. 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

Cada elemento de contactArray descreve um contato na superfície, como um dedo. Os elementos de contactArray que não são gravados com um contato são definidos como zero. O membro contactId de GameInputTouchContact permanece o mesmo enquanto o contato permanecer na superfície, portanto você pode usá-lo para acompanhar um contato entre leituras. Para dimensionar contactArray, chame IGameInputReading::GetTouchContactCount ou use o membro maxContactCount de GameInputTouchSurfaceInfo para alocar uma matriz grande o suficiente para qualquer leitura. Para interpretar as coordenadas do contato, chame IGameInputDevice::GetTouchSurfaceInfo com o mesmo índice de superfície. As leituras que contêm dados de toque incluem GameInputKindTouch em IGameInputReading::GetInputKind.
O suporte ao toque depende do dispositivo e da plataforma.
O exemplo a seguir lê os contatos em todas as superfícies de toque de um dispositivo.

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::GetTouchContactCount
IGameInputDevice::GetTouchSurfaceInfo
GameInputTouchContact
GameInputTouchSurfaceInfo

Histórico de versões

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