메인 콘텐츠로 건너뛰기
사용되지 않음. 이 메서드는 GameInput v4에서 제거되었으며 현재 API에서는 사용할 수 없습니다. 대신 IGameInputReading::GetSystemButtonState와 GameInputKindSystemButton을 사용하여 입력 판독값에서 시스템 버튼 상태를 읽으세요.
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에서 절대 디스패치되지 않습니다. 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

버전 기록

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