메인 콘텐츠로 건너뛰기
입력 판독에서 Guide 및 Share 버튼과 같은 시스템 버튼의 상태를 검색합니다.

구문

매개변수

buttons   _Out_
형식: GameInputSystemButtons*
이 판독값에서 눌려 있는 시스템 버튼 집합을 받습니다.

반환값

형식: bool 판독값에 시스템 버튼 상태가 포함되어 있으면 true를 반환합니다. 포함되어 있지 않으면 false를 반환하며, 이 경우 buttons는 GameInputSystemButtonNone으로 설정됩니다.

설명

GameInput v4에서 시스템 버튼은 일반적인 입력 종류인 GameInputKindSystemButton입니다. 시스템 버튼이 있는 장치의 모든 판독값은 IGameInputReading::GetInputKind에 GameInputKindSystemButton을 포함하며, GetSystemButtonState는 IGameInputReading::GetGamepadState가 게임패드 버튼의 상태를 반환하는 것과 같은 방식으로 해당 버튼의 현재 상태를 반환합니다. 장치에 있는 시스템 버튼을 확인하려면 IGameInputDevice::GetSupportedSystemButtons를 호출하세요. 판독값은 누름 또는 놓음 이벤트가 아니라 어떤 버튼이 눌려 있는지를 보고합니다. 누름 또는 놓음을 감지하려면 상태를 이전 판독값의 상태와 비교하세요. 이 메서드는 이전 버전 GameInput의 IGameInput::RegisterSystemButtonCallback 메서드를 대체합니다. 시스템 버튼 입력을 받으려면 GameInputKindSystemButton과 함께 IGameInput::RegisterReadingCallback을 사용하거나 IGameInput::GetCurrentReading으로 폴링하세요. IGameInput::EnableBackgroundInput으로 백그라운드 입력을 활성화하지 않는 한, 시스템 버튼 입력은 애플리케이션이 포커스를 갖고 있는 동안에만 전달됩니다. 다음 예제는 Guide 버튼의 새로운 누름을 감지하는 방법을 보여줍니다.

요구 사항

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

함께 보기

GameInput 개요
IGameInputReading
GameInputSystemButtons
GameInputKind
IGameInput::EnableBackgroundInput
IGameInputDevice::GetSupportedSystemButtons

버전 기록

마지막 수정일 2026년 11월 6일