Saltar al contenido principal
Recupera los contactos de una superficie táctil de 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. contactArrayCount   _In_
Tipo: uint32_t
Número de elementos de contactArray. contactArray   _Out_writes_to_opt_(contactArrayCount, return)
Tipo: GameInputTouchContact*
Matriz que recibe los contactos de la superficie táctil. Puede ser nula.

Valor devuelto

Tipo: uint32_t Si contactArray es nula, devuelve el número de contactos de la superficie táctil. De lo contrario, devuelve el número de contactos escritos en contactArray, que es el menor del número de contactos y contactArrayCount. Devuelve 0 si la lectura no contiene datos táctiles o si surfaceIndex no es un índice de superficie válido.

Comentarios

Cada elemento de contactArray describe un contacto en la superficie, como un dedo. Los elementos de contactArray en los que no se escribe ningún contacto se establecen en cero. El miembro contactId de GameInputTouchContact no cambia mientras el contacto permanece en la superficie, por lo que puede usarlo para realizar el seguimiento de un contacto entre lecturas. Para dimensionar contactArray, llame a IGameInputReading::GetTouchContactCount o use el miembro maxContactCount de GameInputTouchSurfaceInfo para asignar una matriz lo suficientemente grande para cualquier lectura. Para interpretar las coordenadas de los contactos, llame a IGameInputDevice::GetTouchSurfaceInfo con el mismo índice de superficie. Las lecturas que contienen datos táctiles incluyen GameInputKindTouch en IGameInputReading::GetInputKind.
La compatibilidad táctil depende del dispositivo y de la plataforma.
En el siguiente ejemplo se leen los contactos de todas las superficies táctiles de un dispositivo.

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

Historial de versiones

Última modificación el 6 de noviembre de 2026