> ## 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.

# CreateInputMapper

> CreateInputMapper

# CreateInputMapper

建立 IGameInputMapper 介面，以提供特定輸入類型中指定輸入元素的對應資訊。

## 語法

```cpp theme={null}
HRESULT CreateInputMapper(
    IGameInputMapper** inputMapper
)
```

### 參數

*inputMapper*   \_COM\_Outptr\_\
類型：IGameInputMapper\*\*

產生的 [IGameInputMapper](/zh-TW/reference/input/gameinput/interfaces/igameinputmapper/igameinputmapper) 介面，可提供特定輸入類型中指定輸入元素的對應資訊。

### 傳回值

類型：HRESULT

如果硬體資源不足以建立對應程式，或裝置不支援可對應的輸入類型，此函式會傳回錯誤結果。

## 備註

`CreateInputMapper` 方法會建立 [IGameInputMapper](/zh-TW/reference/input/gameinput/interfaces/igameinputmapper/igameinputmapper) 介面，以提供特定輸入類型中指定輸入元素的對應資訊。會產生對應的輸入類型為 [GameInputKindArcadeStick](/zh-TW/reference/input/gameinput/enums/gameinputkind)、[GameInputKindFlightStick](/zh-TW/reference/input/gameinput/enums/gameinputkind)、[GameInputKindGamepad](/zh-TW/reference/input/gameinput/enums/gameinputkind) 和 [GameInputKindRacingWheel](/zh-TW/reference/input/gameinput/enums/gameinputkind)。如果裝置不支援上述其中一種輸入類型，此方法會傳回錯誤結果。

## 需求

**標頭：** GameInput.h

**程式庫：** gameinput.lib

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[GameInput](/zh-TW/reference/input/gameinput/gameinput_members)<br />
[IGameInputDevice](/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice)

## 版本歷程記錄

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


## Related topics

- [IGameInputDevice](/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)
- [IGameInputMapper](/zh-TW/reference/input/gameinput/interfaces/igameinputmapper/igameinputmapper.md)
- [IGameInputMapper::GetGamepadButtonMapping](/zh-TW/reference/input/gameinput/interfaces/igameinputmapper/methods/igameinputmapper_getgamepadbuttonmappinginfo.md)
- [IGameInputMapper::GetGamepadAxisMappingInfo](/zh-TW/reference/input/gameinput/interfaces/igameinputmapper/methods/igameinputmapper_getgamepadaxismappinginfo.md)
- [IGameInputMapper::GetFlightStickButtonMappingInfo](/zh-TW/reference/input/gameinput/interfaces/igameinputmapper/methods/igameinputmapper_getflightstickbuttonmappinginfo.md)