Pular para o conteúdo principal
Obtém informações sobre uma superfície de toque do dispositivo de entrada.

Sintaxe

Parâmetros

surfaceIndex
Tipo: uint32_t
O índice baseado em zero da superfície de toque. Deve ser menor que o valor retornado por IGameInputDevice::GetTouchSurfaceCount. info   _Out_
Tipo: GameInputTouchSurfaceInfo*
Recebe informações sobre a superfície de toque.

Valor retornado

Tipo: HRESULT Retorna S_OK em caso de êxito. Retorna E_BOUNDS se surfaceIndex for maior ou igual ao número de superfícies de toque do dispositivo; nesse caso, info é zerado.

Comentários

As informações retornadas descrevem o número máximo de contatos simultâneos que a superfície pode relatar, as dimensões da superfície em unidades do dispositivo e o tipo da superfície, como touchpad ou tela sensível ao toque. As posições de contato relatadas por IGameInputReading::GetTouchSurfaceState são relativas a essas dimensões, portanto você pode usá-las para normalizar as posições de contato. As informações não mudam durante o tempo de vida do objeto de dispositivo. O exemplo a seguir normaliza a posição do primeiro contato em cada superfície de toque de um dispositivo para o intervalo [0, 1).
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
IGameInputDevice
GameInputTouchSurfaceInfo
IGameInputDevice::GetTouchSurfaceCount
IGameInputReading::GetTouchSurfaceState

Histórico de versões

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