구문
매개변수
device _In_opt_형식: IGameInputDevice* 선택적으로 등록된 콜백이 특정 장치에 대해 트리거되도록 제한합니다. buttonFilter _In_
형식: GameInputSystemButtons 콜백을 받을 버튼 집합으로, 논리적 OR로 결합됩니다. context _In_opt_
형식: void* 콜백 함수에 관련된 정보를 제공하는 개체입니다. 일반적으로 호출 개체입니다. callbackFunc _In_
형식: GameInputSystemButtonCallback 시스템 버튼이 눌리거나 놓일 때 호출되는 타이틀 정의 콜백 함수입니다. callbackToken _Out_opt_
형식: GameInputCallbackToken* 등록된 콜백 함수를 식별하는 토큰입니다. 이 토큰은 콜백 함수를 취소하거나 등록 해제해야 하는 경우 등록된 함수를 식별하는 데 사용됩니다.
반환값
형식: HRESULT 함수 결과.설명
이 메서드는 Guide 또는 System 버튼이 눌리거나 놓일 때 호출되는 콜백 함수를 등록합니다. 콜백이 발송되는지 여부는 사용자의 프로세스와 다른 프로세스에서 IGameInput::SetFocusPolicy에 의해 설정된 GameInputFocusPolicy에 따라 다릅니다. 자세한 내용은 GameInputFocusPolicy를 참조하세요. XBOX에서는 셸이 항상 Guide 버튼을 소비하므로, 이러한 콜백은 XBOX에서 절대 디스패치되지 않습니다. PC에서 GameInput 런타임이 시스템에 설치되지 않고 애플리케이션과 함께 사이드로드된 경우 이 메서드는GAMEINPUT_E_FEATURE_REQUIRES_INSTALL(0x838AD02B)로 실패합니다. 자세한 내용은 GameInput 사이드로딩을 참조하세요.
콜백 수신을 중지하려면 IGameInput::UnregisterCallback 및 IGameInput::StopCallback 메서드를 참조하세요.
이는 Windows SDK 10.0.26031 미리 보기 GameInput.h에 추가되었으며, 향후 GDK 릴리스에 추가될 예정입니다.
다음 코드 예제는 Guide 버튼 누름을 수신하는 방법을 보여줍니다.
요구 사항
헤더: GameInput.h 라이브러리: gameinput.lib 지원되는 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔함께 보기
사용되지 않는 GameInput API 멤버IGameInputReading::GetSystemButtonState
고급 GameInput 항목
GameInput 개요
IGameInput
