> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GameInputCreate

> GameInputCreate

# GameInputCreate

取得 IGameInput 介面的執行個體。

## 語法

```cpp theme={null}
HRESULT GameInputCreate(
    IGameInput** gameInput
);
```

### 參數

*gameInput*   \_COM\_Outptr\_\
類型：IGameInput\*\*

呼叫所傳回之基礎個別處理序單一資料庫的執行個體。

### 傳回值

類型：HRESULT

函式結果。

## 備註

`GameInputCreate` 函式是用於取得或建立 GameInput 執行個體的 Nano-COM 處理站。產生的介面由個別處理序的單一資料庫支援，此單一資料庫會在第一次呼叫此函式時建立。因此，第一次呼叫此函式可能需要一小段時間才會傳回。這段時間短到通常可以安全地從 UI 執行緒呼叫，但不適合在時間敏感的內容 (例如遊戲迴圈) 中呼叫。之後從同一個處理序呼叫此函式時，只會為基礎單一資料庫新增另一個參考，並且會很快傳回。

由於系統上一次只能有一個 GameInput 版本，因此支援的介面集合可能會依據安裝的 GameInput 版本而有所不同。由於 GameInput 具有回溯相容性，新版本在新增功能的同時，仍會繼續支援舊的介面。

應用程式應該在啟動期間呼叫 `GameInputCreate` 函式一次，並保留 `IGameInput` 物件參考，直到應用程式準備關閉為止。即使是回應處理序生命週期管理 (PLM) 暫停事件的通用 Windows 平台 (UWP) 應用程式也是如此，因為 (在應用程式繼續時) 重新初始化 `GameInput` 單一資料庫的成本，通常會超過在應用程式中釋放少量記憶體的好處。

## 需求

**標頭：** GameInput.h

[進階 GameInput 主題](/zh-TW/build/core-features/common/input/advanced/input-advanced-topics)\
[GameInput 概觀](/zh-TW/build/core-features/common/input/overviews/input-overview)\
[GameInput](/zh-TW/reference/input/gameinput/gameinput_members)

## 版本歷程記錄

| 版本 | 變更 |
| - | - |
| **v0** | 已推出。 |

## 概念文件

* [GameInput 基本概念](/zh-TW/build/core-features/common/input/overviews/input-fundamentals)


## Related topics

- [GameInputCreate](/reference/input/gameinput/functions/gameinputcreate.md)
- [GameInput](/reference/input/gameinput/gameinput_members.md)
- [GameInput frequently asked questions](/build/core-features/common/input/overviews/input-faq.md)
- [Preguntas más frecuentes sobre GameInput](/es/build/core-features/common/input/overviews/input-faq.md)
- [GameInput 常见问题](/zh-CN/build/core-features/common/input/overviews/input-faq.md)