跳转到主要内容
获取有关输入设备上某个触摸表面的信息。

语法

参数

surfaceIndex
类型:uint32_t
触摸表面的从零开始的索引。该值必须小于 IGameInputDevice::GetTouchSurfaceCount 返回的值。 info   _Out_
类型:GameInputTouchSurfaceInfo*
接收有关该触摸表面的信息。

返回值

类型:HRESULT 成功时返回 S_OK。如果 surfaceIndex 大于或等于设备上触摸表面的数量,则返回 E_BOUNDS;在这种情况下,info 会被置零。

备注

返回的信息描述该表面可以报告的最大同时接触点数、以设备单位表示的表面尺寸,以及表面的类型(例如触摸板或触摸屏)。IGameInputReading::GetTouchSurfaceState 报告的接触点位置是相对于这些尺寸的,因此你可以使用这些尺寸来规范化接触点位置。 该信息在设备对象的生存期内不会更改。 以下示例将设备每个触摸表面上第一个接触点的位置规范化到 [0, 1) 范围内。
触摸支持取决于设备和平台。

要求

头文件: GameInput.h 库: gameinput.lib 支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机

另请参阅

GameInput 概述
IGameInputDevice
GameInputTouchSurfaceInfo
IGameInputDevice::GetTouchSurfaceCount
IGameInputReading::GetTouchSurfaceState

版本历史

最后修改于 2026年11月6日