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