Saltar al contenido principal
Obtiene información sobre una superficie táctil del dispositivo de entrada.

Sintaxis

Parámetros

surfaceIndex
Tipo: uint32_t
El índice de base cero de la superficie táctil. Debe ser menor que el valor devuelto por IGameInputDevice::GetTouchSurfaceCount. info   _Out_
Tipo: GameInputTouchSurfaceInfo*
Recibe información sobre la superficie táctil.

Valor devuelto

Tipo: HRESULT Devuelve S_OK si se realiza correctamente. Devuelve E_BOUNDS si surfaceIndex es mayor o igual que el número de superficies táctiles del dispositivo; en ese caso, info se rellena con ceros.

Comentarios

La información devuelta describe el número máximo de contactos simultáneos que puede notificar la superficie, las dimensiones de la superficie en unidades del dispositivo y el tipo de superficie, como un panel táctil o una pantalla táctil. Las posiciones de contacto que notifica IGameInputReading::GetTouchSurfaceState son relativas a estas dimensiones, por lo que puede usarlas para normalizar las posiciones de contacto. La información no cambia durante la vida útil del objeto de dispositivo. En el siguiente ejemplo se normaliza la posición del primer contacto de cada superficie táctil de un dispositivo al intervalo [0, 1).
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
IGameInputDevice
GameInputTouchSurfaceInfo
IGameInputDevice::GetTouchSurfaceCount
IGameInputReading::GetTouchSurfaceState

Historial de versiones

Última modificación el 6 de noviembre de 2026