메인 콘텐츠로 건너뛰기

GetExtraButtonCount

특정 입력 종류에 대해 장치에 있는 추가 버튼(지원되지 않는 버튼)의 수를 가져옵니다.

구문

매개변수

inputKind   _In_
형식: GameInputKind
추가 버튼 수를 요청하는 대상 입력 종류입니다. extraButtonCount   _Out_
형식: uint32_t*
지정된 입력 종류에 대해 장치에 있는 추가 버튼(지원되지 않는 버튼)의 수입니다.

반환값

형식: HRESULT 함수 결과.

설명

추가 버튼은 물리적 장치에 존재하지만 지정된 입력 종류에 대한 표준 매핑의 일부가 아닌 컨트롤러 버튼입니다. 이 메서드는 표준 입력 매핑을 넘어서는 장치별 버튼에 접근하려는 애플리케이션에 유용합니다. 얻은 수는 GetExtraButtonIndexes 메서드와 함께 사용되어 이러한 추가 버튼의 특정 인덱스를 검색하고, 해당 메서드가 제공하는 버튼 인덱스를 저장할 올바른 공간을 버퍼링하는 데 사용됩니다.

요구 사항

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

함께 보기

GameInputKind
GetExtraButtonIndexes
GetExtraAxisCount
IGameInputDevice

버전 기록

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