跳轉到主要內容
擷取輸入讀數中觸控表面上的接觸點數目。

語法

參數

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日