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 miembrocontactId 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.
Requisitos
Encabezado: GameInput.h Biblioteca: gameinput.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX SeriesConsulte también
Información general de GameInputIGameInputReading
IGameInputReading::GetTouchContactCount
IGameInputDevice::GetTouchSurfaceInfo
GameInputTouchContact
GameInputTouchSurfaceInfo
