跳转到主要内容
检索输入读数中某个触摸表面上的接触点数量。

语法

参数

surfaceIndex   _In_
类型:uint32_t
触摸表面的索引。必须小于 IGameInputDevice::GetTouchSurfaceCount 返回的值。

返回值

类型:uint32_t 此读数中该触摸表面上的接触点数量。如果读数不包含触摸数据,或者 surfaceIndex 不是有效的表面索引,则返回 0。

备注

使用此方法确定传递给 IGameInputReading::GetTouchSurfaceState 的数组的大小。使用 null 接触点数组调用 GetTouchSurfaceState 也会返回接触点数量。若要分配一个对任何读数都足够大的数组,请使用 GameInputTouchSurfaceInfo 的 maxContactCount 成员。 包含触摸数据的读数会在 IGameInputReading::GetInputKind 中包含 GameInputKindTouch。
触摸支持取决于设备和平台。

要求

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

另请参阅

GameInput 概述
IGameInputReading
IGameInputReading::GetTouchSurfaceState
IGameInputDevice::GetTouchSurfaceInfo
GameInputTouchContact

版本历史

最后修改于 2026年11月6日