다음을 통해 공유


GameInputReadingCallback

새 읽기 도착 이벤트에 대해 타이틀이 정의한 콜백.

구문

void GameInputReadingCallback(  
         GameInputCallbackToken callbackToken,  
         void* context,  
         IGameInputReading* reading,  
         bool hasOverrunOccurred  
)  

매개 변수

callbackToken _In_
형식: GameInputCallbackToken

콜백을 식별하는 콜백 토큰.
IGameInput::RegisterReadingCallback에서 반환된 토큰.

context _In_
형식: void*

타이틀에서 정의한 컨텍스트.

reading _In_
형식: IGameInputReading*

새로운 읽기.

hasOverrunOccurred _In_
형식: bool

오버런 발생 여부를 나타내는 부울. 오버런 발생은 콜백 분배 스레드가 0.5초 동안 실행되지 않아 읽기 콜백이 건너뛰기되거나 결과적으로 손실된 것을 의미합니다.

반환 값

형식: void

비고

이 함수의 정의는 개발자가 결정하지만, 콜백이 수행되려면 함수의 매개 변수가 일치해야 합니다. 이 함수는 IGameInput::RegisterReadingCallback에 등록된 GameInput 읽기 콜백을 정의하는 데 사용됩니다. 입력 장치에서 원하는 읽기가 수신될 때마다 호출되는 함수를 정의합니다.

GameInput이 기본 디스패처 스레드를 사용하는 경우 오버런이 발생할 가능성은 거의 없습니다. 그러나 앱이 IGameInput:CreateDispatcher 함수를 사용하여 디스패치를 수동으로 제어한 다음 장시간 큐를 펌프하지 못하면 오버런이 발생할 수 있습니다.

요구 사항

헤더: GameInput.h

라이브러리: xgameruntime.lib

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

참고 항목

입력 API 개요
GameInput
IGameInput::RegisterReadingCallback