다음을 통해 공유


GameInputCreate

IGameInput 인터페이스의 인스턴스를 얻습니다.

구문

HRESULT GameInputCreate(  
         IGameInput** gameInput  
)  

매개 변수

gameInput _COM_Outptr_
형식: IGameInput**

호출에서 반환될 프로세스별 기본 싱글톤의 인스턴스.

반환 값

형식: HRESULT

함수 결과입니다.

비고

GameInputCreate 함수는 IGameInput 인터페이스의 인스턴스를 얻기 위한 Nano-COM 팩터리입니다. IGameInput 인터페이스는 이 함수가 처음 호출될 때 생성되는 프로세스별 싱글톤에서 구현됩니다. 따라서 이 함수에 대한 첫 번째 호출은 반환하는 데 약간 시간이 걸립니다. 일반적으로 UI 스레드에서 호출하기에는 안전하지만 게임 루프와 같이 시간에 민감한 컨텍스트에서 호출하기에는 적합하지 않을 수 있습니다. 이 함수의 후속 호출은 단순하게 기본 싱글톤에 참조를 추가하는 역할을 하므로 빠르게 반환됩니다.

응용 프로그램은 시작 시 GameInputCreate 함수를 한 번 호출하고 응용 프로그램이 종료 준비될 때까지 IGameInput 개체 참조를 유지햐야 합니다. 프로세스 수명 관리(PLM) 일시 중단 이벤트에 응답하는 유니버설 Windows 플랫폼(UWP) 앱의 경우에도 마찬가지인데, 그 이유는 일반적으로 (앱 재개 시) GameInput 싱글톤을 다시 초기화하는 비용이 응용 프로그램에서 약간의 메모리를 해제해서 얻는 장점보다 크기 때문입니다.

요건

헤더: GameInput.h

라이브러리: xgameruntime.lib

지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔

참고 항목

고급 GameInput 항목
GameInput 개요
GameInput