跳轉到主要內容
取得可唯一識別輸入裝置的應用程式本機識別碼。

語法

參數

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

傳回值

類型:void

備註

裝置識別碼是應用程式本機識別碼:一個可唯一識別裝置的 256 位元雜湊值。只要裝置連接至相同的 USB 連接埠,即使在應用程式的多次執行或系統重新開機之間,指定裝置的此識別碼也會保持不變。此雜湊部分是根據呼叫端應用程式和系統特有的資訊產生,因此同一個裝置在不同的應用程式中會有不同的識別碼。 由於此識別碼是穩定的,您可以將其儲存起來以記住某個裝置 (例如使用者慣用的控制器),之後再呼叫 IGameInput::FindDeviceFromId 查詢相符的裝置物件。 對於屬於複合裝置上多個介面之一的裝置,請使用 IGameInputDevice::GetDeviceRootId 取得根裝置的識別碼。如果裝置不屬於複合裝置,則裝置識別碼和根裝置識別碼會相同。 在 GameInput v3 及更早版本中,此資訊可從 IGameInputDevice::GetDeviceInfo 所傳回 GameInputDeviceInfo 結構的 deviceId 成員取得。

需求

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

另請參閱

GameInput 概觀
IGameInputDevice
IGameInputDevice::GetDeviceRootId
IGameInput::FindDeviceFromId
APP_LOCAL_DEVICE_ID

版本歷程記錄

最後修改於 2026年11月6日