구문
매개변수
labelArrayCount _In_형식: uint32_t labelArray의 요소 수입니다. 모든 컨트롤러 버튼 레이블을 검색하려면 GetControllerButtonCount가 반환하는 값을 전달하세요. labelArray _Out_writes_to_opt_(labelArrayCount, return)
형식: GameInputLabel* 컨트롤러 버튼당 하나의 레이블을 받는 배열에 대한 포인터입니다.
nullptr일 수 있으며, 이 경우 아무것도 기록되지 않고 메서드는 0을 반환합니다.
반환값
형식: uint32_t labelArray에 기록된 요소 수입니다. labelArrayCount와 장치의 컨트롤러 버튼 레이블 수 중 작은 값이며, labelArray가nullptr이거나 장치에 컨트롤러 버튼 레이블이 없으면 0입니다.
설명
각 요소는 장치가 보고하는 경우 해당 버튼에 인쇄된 표시를 식별하는 GameInputLabel 값입니다. GetControllerButtonCount를 호출하여 컨트롤러 버튼 레이블 수를 가져오고, 해당 크기의 배열을 할당한 다음,GetControllerButtonLabels를 호출하여 배열을 채우세요. labelArrayCount가 컨트롤러 버튼 레이블 수보다 작으면 처음 labelArrayCount개의 요소만 기록됩니다. 장치의 컨트롤러 버튼 레이블은 장치가 연결되어 있는 동안 변경되지 않으므로 한 번 쿼리하고 결과를 캐시할 수 있습니다.
레이블 배열의 요소 i는 이 장치의 판독값에 대해 IGameInputReading::GetControllerButtonState가 반환하는 배열의 인덱스 i에 있는 버튼을 설명합니다.
다음 예제는 장치의 컨트롤러 버튼 레이블을 검색하는 방법을 보여줍니다.
controllerInfo 멤버가 참조하는 GameInputControllerInfo 구조체의 controllerButtonLabels 멤버에서 이 정보를 얻을 수 있었습니다.
요구 사항
헤더: GameInput.h 라이브러리: gameinput.lib 지원되는 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔함께 보기
GameInput 개요GetControllerButtonCount
GameInputLabel
IGameInputReading::GetControllerButtonState
IGameInputDevice
