IGameInput::RegisterSystemButtonCallback
Guide 또는 Share 버튼이 눌리거나 놓일 때 호출되는 콜백 함수를 등록합니다.구문
매개변수
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에서 절대 디스패치되지 않습니다. 콜백 수신을 중지하려면 IGameInput::UnregisterCallback 및 IGameInput::StopCallback 메서드를 참조하세요. 이는 Windows SDK 10.0.26031 미리 보기 GameInput.h에 추가되었으며, 향후 GDK 릴리스에 추가될 예정입니다. 다음 코드 예제는 Guide 버튼 누름을 수신하는 방법을 보여줍니다.요구 사항
헤더: GameInput.h 라이브러리: gameinput.lib 지원되는 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔함께 보기
고급 GameInput 항목GameInput 개요
IGameInput
