跳轉到主要內容
取得輸入裝置之根裝置節點的應用程式本機識別碼。

語法

參數

deviceRootId   _Out_
類型:APP_LOCAL_DEVICE_ID*
接收根裝置節點的應用程式本機識別碼。

傳回值

類型:void

備註

根裝置識別碼是應用程式本機識別碼,用來識別複合裝置的根裝置節點。這可讓應用程式推斷個別裝置之間的關係。例如,某些遊戲鍵盤會將自己公開為具有多個鍵盤節點的複合裝置,藉此因應舊版 USB 同時按鍵數最多八個的限制。這些節點會合併成「系統」鍵盤,因此通常對使用者而言是透明的。但在使用 GameInput API 處理個別鍵盤的輸入時,了解這種關係有助於應用程式在將功能對應至按鍵時,避免做出不當的假設 (例如,按鍵一律來自特定裝置)。 回報相同根裝置識別碼的裝置屬於同一個複合裝置。如果裝置不是複合裝置上多個介面之一,則根裝置識別碼會與 IGameInputDevice::GetDeviceId 傳回的識別碼相同。 在 GameInput v3 及更早版本中,此資訊可從 IGameInputDevice::GetDeviceInfo 所傳回 GameInputDeviceInfo 結構的 deviceRootId 成員取得。

需求

標頭: GameInput.h 程式庫: gameinput.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

另請參閱

GameInput 概觀
IGameInputDevice
IGameInputDevice::GetDeviceId
IGameInputDevice::GetContainerId
APP_LOCAL_DEVICE_ID

版本歷程記錄

最後修改於 2026年11月6日