> ## 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/ko/reference/input/gameinput/enums/gameinputgamepadbuttons.md)

매핑을 쿼리하는 특정 게임패드 버튼입니다.

*mapping*   \_Out\_\
형식: [GameInputButtonMapping](https://docs.xbox.com/ko/reference/input/gameinput/structs/gameinputbuttonmapping.md)

버튼이 컨트롤러의 축, 버튼 또는 스위치로부터 어떻게 매핑되는지에 대한 매핑 정보입니다.

### 반환값

형식: bool

매핑이 성공적으로 검색되었는지 여부입니다. 장치가 [GameInputKindGamepad](https://docs.xbox.com/ko/reference/input/gameinput/enums/gameinputkind.md) 입력 종류를 지원하지 않거나 지정된 버튼 요소가 장치에서 지원되지 않는 경우 이 값은 false입니다.

## 요구 사항

**헤더:** GameInput.h

**라이브러리:** gameinput.lib

**지원되는 플랫폼:** Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 함께 보기

[Input API 개요](https://docs.xbox.com/ko/build/core-features/common/input/overviews/input-overview.md)\

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

## 버전 기록

| 버전 | 변경 사항 |
| - | - |
| **v3** | 도입됨. |


## Related topics

- [IGameInputMapper (인터페이스 콘텐츠)](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputmapper/igameinputmapper.md)
- [GameInputGamepadButtons](https://docs.xbox.com/ko/reference/input/gameinput/enums/gameinputgamepadbuttons.md)
- [GetGamepadAxisMappingInfo](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputmapper/methods/igameinputmapper_getgamepadaxismappinginfo.md)
- [GetFlightStickButtonMappingInfo](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputmapper/methods/igameinputmapper_getflightstickbuttonmappinginfo.md)
- [GetRacingWheelButtonMappingInfo](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputmapper/methods/igameinputmapper_getracingwheelbuttonmappinginfo.md)