Skip to main content

GameInputCreate

IGameInput 인터페이스의 인스턴스를 가져옵니다.

구문

매개변수

gameInput   _COM_Outptr_
형식: IGameInput**
호출을 통해 반환되는 프로세스당 싱글톤의 인스턴스입니다.

반환값

형식: HRESULT 함수 결과입니다.

설명

GameInputCreate 함수는 GameInput의 인스턴스를 가져오거나 만들기 위한 Nano-COM 팩터리입니다. 반환되는 인터페이스는 이 함수가 처음 호출될 때 생성되는 프로세스당 싱글톤에 의해 뒷받침됩니다. 따라서 이 함수의 첫 번째 호출은 반환되는 데 짧은 시간이 걸릴 수 있지만, 일반적으로 UI 스레드에서 호출하기에는 충분히 짧고 게임 루프와 같은 시간에 민감한 컨텍스트에서는 호출하지 않는 것이 좋습니다. 동일한 프로세스에서 이 함수를 이후에 호출하면 기본 싱글톤에 대한 참조가 추가되고 빠르게 반환됩니다. 시스템에서 한 번에 하나의 GameInput 버전만 사용할 수 있으므로 지원되는 인터페이스 집합은 설치된 GameInput 버전에 따라 달라질 수 있습니다. GameInput은 이전 버전과 호환되므로 새 기능이 추가되더라도 새 릴리스는 이전 인터페이스를 계속 지원합니다. 애플리케이션은 시작 시 GameInputCreate 함수를 한 번 호출하고 애플리케이션이 종료될 준비가 될 때까지 IGameInput 개체 참조를 유지해야 합니다. 이는 프로세스 수명 관리(PLM) 일시 중단 이벤트에 응답하는 유니버설 Windows 플랫폼(UWP) 앱의 경우에도 마찬가지입니다. 앱이 다시 시작될 때 GameInput 싱글톤을 다시 초기화하는 비용이 애플리케이션에서 적은 양의 메모리를 해제하는 이점보다 일반적으로 더 크기 때문입니다.

요구 사항

헤더: GameInput.h 고급 GameInput 항목
GameInput 개요
GameInput

버전 기록

개념 문서

마지막 수정일 2026년 8월 13일