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

# GetGamepadButtonMappingInfo

> IGameInputMapper::GetGamepadButtonMapping

# IGameInputMapper::GetGamepadButtonMapping

## 語法

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

### 參數

*buttonElement*   \_In\_\
類型：[GameInputGamepadButtons](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputgamepadbuttons.md)

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

*mapping*   \_Out\_\
類型：[GameInputButtonMapping](https://docs.xbox.com/zh-TW/reference/input/gameinput/structs/gameinputbuttonmapping.md)

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

### 傳回值

類型：bool

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

## 需求

**標頭：** GameInput.h

**程式庫：** gameinput.lib

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

## 另請參閱

[輸入 API 概觀](https://docs.xbox.com/zh-TW/build/core-features/common/input/overviews/input-overview.md)\

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

## 版本歷程記錄

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


## Related topics

- [GameInputGamepadButtons](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputgamepadbuttons.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)
- [GetArcadeStickButtonMappingInfo](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputmapper/methods/igameinputmapper_getarcadestickbuttonmappinginfo.md)
- [GetFlightStickButtonMappingInfo](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputmapper/methods/igameinputmapper_getflightstickbuttonmappinginfo.md)