IGameInput 인터페이스의 인스턴스를 얻습니다.
구문
HRESULT GameInputCreate(
IGameInput** gameInput
);
매개 변수
gameInput _COM_Outptr_
형식: IGameInput**
호출에서 반환될 프로세스별 기본 싱글톤의 인스턴스.
반환 값
형식: HRESULT
함수 결과입니다.
비고
이 GameInputCreate 함수는 GameInput 인스턴스를 가져오거나 만들기 위한 Nano-COM 팩터리입니다. 결과 인터페이스는 이 함수가 처음 호출될 때 만들어진 프로세스별 싱글톤에 의해 지원됩니다. 따라서 이 함수에 대한 첫 번째 호출은 반환하는 데 약간 시간이 걸립니다. 일반적으로 UI 스레드에서 호출하기에는 안전하지만 게임 루프와 같이 시간에 민감한 컨텍스트에서 호출하기에는 적합하지 않을 수 있습니다. 이 함수의 후속 호출은 단순하게 기본 싱글톤에 참조를 추가하는 역할을 하므로 빠르게 반환됩니다.
한 번에 하나의 버전의 GameInput만 시스템에서 사용할 수 있으므로 지원되는 인터페이스 집합은 설치된 GameInput 버전에 따라 달라질 수 있습니다. GameInput은 이전 버전과 호환되므로 새 기능이 추가되는 경우에도 새 릴리스는 이전 인터페이스를 계속 지원합니다.
응용 프로그램은 시작 시 GameInputCreate 함수를 한 번 호출하고 응용 프로그램이 종료 준비될 때까지 IGameInput 개체 참조를 유지햐야 합니다. 프로세스 수명 관리(PLM) 일시 중단 이벤트에 응답하는 유니버설 Windows 플랫폼(UWP) 앱의 경우에도 마찬가지인데, 그 이유는 일반적으로 (앱 재개 시) GameInput 싱글톤을 다시 초기화하는 비용이 응용 프로그램에서 약간의 메모리를 해제해서 얻는 장점보다 크기 때문입니다.
요건
헤더: GameInput.h