> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XGameStreamingGetStreamAddedLatency

> XGameStreamingGetStreamAddedLatency

# XGameStreamingGetStreamAddedLatency

최근 평균 스트리밍 관련 지연 시간을 가져옵니다.

## 구문

```cpp theme={null}
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\*

최근 기간 동안 지연 시간에서 관측된 지터(jitter)의 평균 측정 표준 편차(마이크로초 단위)입니다.

### 반환 값

형식: HRESULT

성공하면 **S\_OK**를 반환하고, 그렇지 않으면 오류 코드를 반환합니다.

#### 잠재적 오류

| 오류 코드                              | 오류 값       | 오류 원인                                                                                                                                                    |
| ---------------------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| E\_GAMESTREAMING\_NOT\_INITIALIZED | 0x89245400 | XGameStreaming 런타임이 초기화되지 않았습니다. 다른 API를 호출하기 전에 [XGameStreamingInitialize](/reference/system/xgamestreaming/functions/xgamestreaminginitialize)를 호출하세요. |
| E\_GAMESTREAMING\_NO\_DATA         | 0x89245402 | 요청한 데이터를 사용할 수 없습니다. 데이터는 나중에 사용할 수 있게 될 수 있습니다.                                                                                                         |

오류 코드 목록은 [오류 코드](/reference/errorcodes)를 참조하세요.

## 설명

<Note>이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한 내용은 [시간에 민감한 스레드](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)를 참조하세요.</Note>

<Note>아래에 설명된 것처럼, 입력 지연 값과 출력 지연 값은 서로 다른 값을 측정하며 서로 다른 소스에서 계산될 수 있습니다. 이 값들은 유사할 것으로 예상되지 않으므로 서로 독립적으로 취급되어야 합니다.</Note>

`XGameStreamingGetStreamAddedLatency`는 게임 스트리밍으로 인해 측정된 지연 시간에 대한 데이터를 제공합니다. 게임은 이 데이터를 활용하여 플레이어가 스트리밍 환경에서 경험하고 있는 지연을 더 잘 이해할 수 있습니다.

이 API는 플레이어가 인지할 수 있는 전체 종단 간(end-to-end) 지연 시간은 제공하지 **않는다**는 점에 유의해야 합니다(예: 스트리밍 클라이언트 장치에 연결된 컨트롤러의 버튼 누름부터 그 결과가 반영된 새 프레임이 렌더링될 때까지의 시간에 직접 대응되지 **않습니다**). 예를 들어 다음 구성 요소는 이 측정에 포함되지 **않습니다**.

* 게임 엔진 렌더링 시간
* 클라이언트 장치에서 렌더링을 위해 전달된 시점부터 플레이어가 이미지를 볼 때까지의 시간
* 클라이언트 장치의 컨트롤러에서의 Bluetooth® 전송 및 디코딩 시간

대신 입력 지연에는 다음이 포함됩니다.

* 게임 스트리밍 애플리케이션이 컨트롤러에서 수신한 입력을 처리하는 데 걸리는 시간.
* 게임 스트리밍 애플리케이션에서 게임을 실행 중인 서버까지 네트워크를 통한 전송 시간.

출력 지연에는 다음이 포함됩니다.

* 타이틀이 렌더링한 각 프레임의 인코딩 시간.
* 이 프레임을 플레이어가 상호 작용 중인 애플리케이션까지 네트워크를 통해 전송하는 시간.
* 애플리케이션이 프레임을 플레이어에게 표시할 준비를 하면서 수행하는 디코딩 시간.

`XGameStreamingGetStreamAddedLatency`는 몇 초마다 업데이트되는 평균 측정값입니다. 보다 정밀한 측정이 필요한 경우 [XGameStreamingGetAssociatedFrame](/reference/system/xgamestreaming/functions/xgamestreaminggetassociatedframe) API를 사용할 수 있습니다. 자세한 내용은 [게임 스트리밍 지연 보정 심층 분석](/build/core-features/common/game-streaming/game-streaming-latency-compensation-deep-dive)을 참조하세요.

## 요구 사항

**헤더:** xgamestreaming.h

**라이브러리:** xgameruntime.lib

**지원 플랫폼:** Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔

## 개념 문서

* [게임 스트리밍 지연 보정 심층 분석](/build/core-features/common/game-streaming/game-streaming-latency-compensation-deep-dive)
* [시간에 민감한 스레드](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## 함께 보기

[XGameStreaming](/reference/system/xgamestreaming/xgamestreaming_members)\
[게임 스트리밍 지연 보정 개요](/build/core-features/common/game-streaming/game-streaming-latency-compensation-overview)


## Related topics

- [게임 스트리밍 지연 시간 보정 심층 분석](/ko/build/core-features/common/game-streaming/game-streaming-latency-compensation-deep-dive.md)
- [XGameStreaming](/ko/reference/system/xgamestreaming/xgamestreaming_members.md)
- [XGameStreamingGetAssociatedFrame](/ko/reference/system/xgamestreaming/functions/xgamestreaminggetassociatedframe.md)
- [XGameStreamingGetLastFrameDisplayed](/ko/reference/system/xgamestreaming/functions/xgamestreaminggetlastframedisplayed.md)
- [게임 스트리밍 지연 시간 측정](/ko/build/core-features/common/game-streaming/game-streaming-latency-measurement.md)