메인 콘텐츠로 건너뛰기

GetExtraButtonIndexes

특정 입력 종류에 대해 장치의 추가 버튼의 컨트롤러 버튼 인덱스를 가져옵니다.

구문

매개변수

inputKind   _In_
형식: GameInputKind
추가 버튼 인덱스를 요청하는 대상 입력 종류입니다. extraButtonCount   _In_
형식: uint32_t
추가 버튼의 예상되는 버튼 인덱스 수입니다. 이 숫자는 GetExtraButtonCount를 호출하여 검색할 수 있습니다. extraButtonIndexes   _Out_writes_(extraButtonCount)_
형식: uint8_t*
버튼 인덱스 배열에 대한 포인터입니다.

반환값

형식: HRESULT 함수 결과.

설명

추가 버튼은 물리적 장치에 존재하지만 지정된 입력 종류에 대한 표준 매핑의 일부가 아닌 컨트롤러 버튼입니다. 이 메서드를 호출하기 전에 먼저 GetExtraButtonCount를 호출하여 사용 가능한 추가 버튼이 몇 개인지 확인한 다음, 그 수를 extraButtonCount 매개변수로 전달해야 합니다. 다음 코드 조각은 게임패드의 추가 버튼을 활용하는 방법을 보여줍니다:

요구 사항

헤더: GameInput.h 라이브러리: gameinput.lib 지원되는 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

함께 보기

GameInputKind
GetExtraButtonCount
GetExtraAxisIndexes
IGameInputDevice

버전 기록

마지막 수정일 2026년 10월 19일