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

# IGameInputMapper::GetGamepadButtonMapping

> IGameInputMapper::GetGamepadButtonMapping

# IGameInputMapper::GetGamepadButtonMapping

## 語法

```cpp theme={null}
bool GetGamepadButtonMappingInfo(
    GameInputGamepadButtons buttonElement,
    GameInputButtonMapping* mapping
);
```

### 參數

*buttonElement*   \_In\_\
類型：[GameInputGamepadButtons](/zh-TW/reference/input/gameinput/enums/gameinputgamepadbuttons)

要查詢其對應的特定遊戲台按鈕。

*mapping*   \_Out\_\
類型：[GameInputButtonMapping](/zh-TW/reference/input/gameinput/structs/gameinputbuttonmapping)

對應資訊，說明此按鈕如何從控制器的軸、按鈕或開關進行對應。

### 傳回值

類型：bool

是否已成功擷取對應。如果裝置不支援 [GameInputKindGamepad](/zh-TW/reference/input/gameinput/enums/gameinputkind) 輸入種類，或裝置不支援指定的按鈕元素，此值為 false。

## 需求

**標頭：** GameInput.h

**程式庫：** gameinput.lib

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

## 另請參閱

[輸入 API 概觀](/zh-TW/build/core-features/common/input/overviews/input-overview)<br />
[IGameInputMapper](/zh-TW/reference/input/gameinput/interfaces/igameinputmapper/igameinputmapper)

## 版本歷程記錄

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


## Related topics

- [IGameInputMapper::GetGamepadButtonMapping](/reference/input/gameinput/interfaces/igameinputmapper/methods/igameinputmapper_getgamepadbuttonmappinginfo.md)
- [IGameInputMapper::GetGamepadAxisMappingInfo](/reference/input/gameinput/interfaces/igameinputmapper/methods/igameinputmapper_getgamepadaxismappinginfo.md)
- [IGameInputMapper::GetRacingWheelButtonMappingInfo](/reference/input/gameinput/interfaces/igameinputmapper/methods/igameinputmapper_getracingwheelbuttonmappinginfo.md)
- [IGameInputMapper::GetArcadeStickButtonMappingInfo](/reference/input/gameinput/interfaces/igameinputmapper/methods/igameinputmapper_getarcadestickbuttonmappinginfo.md)
- [IGameInputMapper::GetFlightStickButtonMappingInfo](/reference/input/gameinput/interfaces/igameinputmapper/methods/igameinputmapper_getflightstickbuttonmappinginfo.md)