IGameInputReading::GetMouseState
마우스 상태를 기술하는 입력 수치에 대한 보기를 검색합니다.
구문
bool GetMouseState(
GameInputMouseState* state
)
매개 변수
state _Out_
형식: GameInputMouseState*
마우스로 해석되는 입력입니다.
반환 값
형식: bool
마우스 입력을 성공적으로 해석한 경우 true를 반환합니다. 마우스 입력으로 인식되지 않는 입력을 읽으려고 시도할 때는 false를 반환합니다.
비고
IGameInputReading::GetInputKind 메서드를 호출하여 일부 IGameInputReading에 대한 유효한 해석을 반환하는 Get\*State 함수를 확인하세요. 각 Get*State 함수에는 IGameInputReading::GetInputKind 열거형에 대응하는 항목이 존재합니다. 해당 IGameInputReading::GetInputKind 플래그가 설정되지 않은 상태로 Get*State 함수를 호출하려고 시도하면, 함수가 false 반환 값과 함께 사용되지 않는 값의 기본값으로 반환합니다.
마우스 이동은 기본적으로 절대 위치가 아닌 일련의 델타 값으로 장치에서 보고됩니다. 하지만 현재 마우스 수치를 주기적으로 확인하면 중간의 여러 델타 값을 놓칠 가능성이 높기 때문에 폴링 API와 호환성이 높지 않습니다. GameInput API는 폴링 API를 사용하는 앱이 잠재적으로 수십 개의 과거 마우스 읽기를 살펴보도록 강제하고, 델타를 추가하는 대신 델타를 가상 "위치" 값으로 지속해서 누적하여 마우스 움직임을 노출합니다. 그런 다음 응용 프로그램은 이전 읽기에서 얻은 "위치" 값을 빼서 자체 델타를 계산합니다. 이렇게 하면 연속 읽기 값으로 계산할 경우 개별 델타에 액세스하거나, 중간 읽기 값을 의도적으로 건너뛴 경우 누적 델타에 액세스할 수 있습니다. 마우스 "위치" 값은 모든 이동 델타의 합계일 뿐이며 화면 공간 좌표와 어느 방식으로도 관련이 없다는 것을 강조해야 합니다.
요건
헤더: GameInput.h
라이브러리: xgameruntime.lib
지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔