XGameStreamingGetStreamAddedLatency
최근 평균 스트리밍 관련 지연 시간을 가져옵니다.구문
매개 변수
client _In_형식: XGameStreamingClientId 지연 시간을 쿼리 대상 스트리밍 클라이언트 장치입니다. averageInputLatencyUs _Out_
형식: uint32_t* 최근 기간 동안 XBOX 게임에서 입력을 수신하기까지의 평균 지연 시간(마이크로초 단위)입니다. averageOutputLatencyUs _Out_
형식: uint32_t* 최근 기간 동안 게임 프레임이 클라이언트 장치에서 렌더링되기까지의 평균 지연 시간(마이크로초 단위)입니다. standardDeviationUs _Out_
형식: uint32_t* 최근 기간 동안 지연 시간에서 관측된 지터(jitter)의 평균 측정 표준 편차(마이크로초 단위)입니다.
반환 값
형식: HRESULT 성공하면 S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다.잠재적 오류
오류 코드 목록은 오류 코드를 참조하세요.
설명
이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
아래에 설명된 것처럼, 입력 지연 값과 출력 지연 값은 서로 다른 값을 측정하며 서로 다른 소스에서 계산될 수 있습니다. 이 값들은 유사할 것으로 예상되지 않으므로 서로 독립적으로 취급되어야 합니다.
XGameStreamingGetStreamAddedLatency는 게임 스트리밍으로 인해 측정된 지연 시간에 대한 데이터를 제공합니다. 게임은 이 데이터를 활용하여 플레이어가 스트리밍 환경에서 경험하고 있는 지연을 더 잘 이해할 수 있습니다.
이 API는 플레이어가 인지할 수 있는 전체 종단 간(end-to-end) 지연 시간은 제공하지 않는다는 점에 유의해야 합니다(예: 스트리밍 클라이언트 장치에 연결된 컨트롤러의 버튼 누름부터 그 결과가 반영된 새 프레임이 렌더링될 때까지의 시간에 직접 대응되지 않습니다). 예를 들어 다음 구성 요소는 이 측정에 포함되지 않습니다.
- 게임 엔진 렌더링 시간
- 클라이언트 장치에서 렌더링을 위해 전달된 시점부터 플레이어가 이미지를 볼 때까지의 시간
- 클라이언트 장치의 컨트롤러에서의 Bluetooth® 전송 및 디코딩 시간
- 게임 스트리밍 애플리케이션이 컨트롤러에서 수신한 입력을 처리하는 데 걸리는 시간.
- 게임 스트리밍 애플리케이션에서 게임을 실행 중인 서버까지 네트워크를 통한 전송 시간.
- 타이틀이 렌더링한 각 프레임의 인코딩 시간.
- 이 프레임을 플레이어가 상호 작용 중인 애플리케이션까지 네트워크를 통해 전송하는 시간.
- 애플리케이션이 프레임을 플레이어에게 표시할 준비를 하면서 수행하는 디코딩 시간.
XGameStreamingGetStreamAddedLatency는 몇 초마다 업데이트되는 평균 측정값입니다. 보다 정밀한 측정이 필요한 경우 XGameStreamingGetAssociatedFrame API를 사용할 수 있습니다. 자세한 내용은 게임 스트리밍 지연 보정 심층 분석을 참조하세요.
요구 사항
헤더: xgamestreaming.h 라이브러리: xgameruntime.lib 지원 플랫폼: Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔개념 문서
함께 보기
XGameStreaming게임 스트리밍 지연 보정 개요