跳轉到主要內容
取得輸入裝置上觸控表面的相關資訊。

語法

參數

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日