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