메인 콘텐츠로 건너뛰기

GetExtraAxisIndexes

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

구문

매개변수

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

반환값

형식: HRESULT 함수 결과.

설명

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

요구 사항

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

함께 보기

GameInputKind
GetExtraAxisCount
GetExtraButtonIndexes
IGameInputDevice

버전 기록

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