> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputmapper/igameinputmapper.md) 介面，可提供特定輸入類型中指定輸入元素的對應資訊。

### 傳回值

類型：HRESULT

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

## 備註

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

## 需求

**標頭：** GameInput.h

**程式庫：** gameinput.lib

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

## 另請參閱

[GameInput](https://docs.xbox.com/zh-TW/reference/input/gameinput/gameinput_members.md)\

[IGameInputDevice](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)

## 版本歷程記錄

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


## Related topics

- [IGameInputDevice (介面內容)](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)
- [IGameInputMapper (介面內容)](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputmapper/igameinputmapper.md)
- [GetGamepadAxisMappingInfo](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputmapper/methods/igameinputmapper_getgamepadaxismappinginfo.md)
- [GetGamepadButtonMappingInfo](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputmapper/methods/igameinputmapper_getgamepadbuttonmappinginfo.md)
- [GetArcadeStickButtonMappingInfo](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputmapper/methods/igameinputmapper_getarcadestickbuttonmappinginfo.md)