GameInputCreate
取得 IGameInput 介面的執行個體。語法
參數
gameInput _COM_Outptr_類型:IGameInput** 呼叫所傳回之基礎個別處理序單一資料庫的執行個體。
傳回值
類型:HRESULT 函式結果。備註
GameInputCreate 函式是用於取得或建立 GameInput 執行個體的 Nano-COM 處理站。產生的介面由個別處理序的單一資料庫支援,此單一資料庫會在第一次呼叫此函式時建立。因此,第一次呼叫此函式可能需要一小段時間才會傳回。這段時間短到通常可以安全地從 UI 執行緒呼叫,但不適合在時間敏感的內容 (例如遊戲迴圈) 中呼叫。之後從同一個處理序呼叫此函式時,只會為基礎單一資料庫新增另一個參考,並且會很快傳回。
由於系統上一次只能有一個 GameInput 版本,因此支援的介面集合可能會依據安裝的 GameInput 版本而有所不同。由於 GameInput 具有回溯相容性,新版本在新增功能的同時,仍會繼續支援舊的介面。
應用程式應該在啟動期間呼叫 GameInputCreate 函式一次,並保留 IGameInput 物件參考,直到應用程式準備關閉為止。即使是回應處理序生命週期管理 (PLM) 暫停事件的通用 Windows 平台 (UWP) 應用程式也是如此,因為 (在應用程式繼續時) 重新初始化 GameInput 單一資料庫的成本,通常會超過在應用程式中釋放少量記憶體的好處。
需求
標頭: GameInput.h 進階 GameInput 主題GameInput 概觀
GameInput
