Saltar al contenido principal
Recupera el número de contactos de una superficie táctil en una lectura de entrada.

Sintaxis

Parámetros

surfaceIndex   _In_
Tipo: uint32_t
Índice de la superficie táctil. Debe ser menor que el valor devuelto por IGameInputDevice::GetTouchSurfaceCount.

Valor devuelto

Tipo: uint32_t El número de contactos de la superficie táctil en esta lectura. Devuelve 0 si la lectura no contiene datos táctiles o si surfaceIndex no es un índice de superficie válido.

Comentarios

Use este método para dimensionar la matriz que se pasa a IGameInputReading::GetTouchSurfaceState. Al llamar a GetTouchSurfaceState con una matriz de contactos nula también se devuelve el número de contactos. Para asignar una matriz lo suficientemente grande para cualquier lectura, use el miembro maxContactCount de GameInputTouchSurfaceInfo. Las lecturas que contienen datos táctiles incluyen GameInputKindTouch en IGameInputReading::GetInputKind.
La compatibilidad táctil depende del dispositivo y de la plataforma.

Requisitos

Encabezado: GameInput.h Biblioteca: gameinput.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

Consulte también

Información general de GameInput
IGameInputReading
IGameInputReading::GetTouchSurfaceState
IGameInputDevice::GetTouchSurfaceInfo
GameInputTouchContact

Historial de versiones

Última modificación el 6 de noviembre de 2026