> ## 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

ストリーミングに関連するレイテンシの直近の平均を取得します。

## Syntax

```cpp theme={null}
HRESULT XGameStreamingGetStreamAddedLatency(  
         XGameStreamingClientId client,  
         uint32_t* averageInputLatencyUs,  
         uint32_t* averageOutputLatencyUs,  
         uint32_t* standardDeviationUs  
)  
```

### Parameters

*client*   \_In\_\
型: XGameStreamingClientId

レイテンシを照会するストリーミング クライアント デバイス。

*averageInputLatencyUs*   \_Out\_\
型: uint32\_t\*

XBOX のゲームが入力を受信するまでの、直近の期間における平均レイテンシ (マイクロ秒単位)。

*averageOutputLatencyUs*   \_Out\_\
型: uint32\_t\*

ゲーム フレームがクライアント デバイスにレンダリングされるまでの、直近の期間における平均レイテンシ (マイクロ秒単位)。

*standardDeviationUs*   \_Out\_\
型: uint32\_t\*

直近の期間におけるレイテンシのジッターの測定された標準偏差の観測平均 (マイクロ秒単位)。

### Return value

型: HRESULT

成功した場合は **S\_OK** を返します。それ以外の場合はエラー コードを返します。

#### 想定されるエラー

| エラー コード                            | エラー値       | エラーの理由                                                                                                                                                     |
| ---------------------------------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| E\_GAMESTREAMING\_NOT\_INITIALIZED | 0x89245400 | XGameStreaming ランタイムが初期化されていません。他の API を呼び出す前に [XGameStreamingInitialize](/reference/system/xgamestreaming/functions/xgamestreaminginitialize) を呼び出してください。 |
| E\_GAMESTREAMING\_NO\_DATA         | 0x89245402 | 要求されたデータは利用できません。データは後で利用可能になる場合があります。                                                                                                                     |

エラー コードの一覧については、[Error Codes](/reference/errorcodes) を参照してください。

## Remarks

<Note>この関数は、時間制約のあるスレッドで呼び出すには安全ではありません。詳細については、[時間制約のあるスレッド](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)を参照してください。</Note>

<Note>以下で説明するように、入力と出力のレイテンシ値は異なる値を測定しており、異なるソースから計算される場合があります。これらの値は類似することを想定しておらず、独立して扱う必要があります。</Note>

`XGameStreamingGetStreamAddedLatency` は、ゲームのストリーミングに起因する測定されたレイテンシに関するデータを提供します。ゲームはこれを利用して、プレイヤーがストリーミング エクスペリエンスで受けている体験をより正確に把握できます。

これは、プレイヤーが体感する可能性のあるエンドツーエンドのレイテンシを **提供しない** 点に注意してください (例: ストリーミング クライアント デバイスに接続されたコントローラーのボタン押下から、それを反映した新しいフレームがレンダリングされるまでの経路に直接対応するわけではありません)。たとえば、次のコンポーネントはこれらの測定に **含まれません**。

* ゲーム エンジンのレンダリング時間
* クライアント デバイスでレンダリングに渡されてから、プレイヤーが映像を目にするまでの時間
* クライアント デバイス上のコントローラーからの Bluetooth® の転送およびデコード時間

入力レイテンシには次が含まれます。

* ゲーム ストリーミング アプリケーションがコントローラーから受信した入力を処理する時間。
* ゲーム ストリーミング アプリケーションからネットワーク経由でゲームを実行しているサーバーへの伝送時間。

出力レイテンシには次が含まれます。

* タイトルによってレンダリングされる各フレームのエンコード時間。
* このフレームをネットワーク経由でプレイヤーが操作しているアプリケーションへ伝送する時間。
* フレームをプレイヤーに提示する準備を行うためのアプリケーション内でのデコード時間。

`XGameStreamingGetStreamAddedLatency` は、数秒ごとに更新される平均測定値です。より精密な測定には [XGameStreamingGetAssociatedFrame](/reference/system/xgamestreaming/functions/xgamestreaminggetassociatedframe) API を使用できます。詳細については [Game streaming latency compensation deep dive](/build/core-features/common/game-streaming/game-streaming-latency-compensation-deep-dive) を参照してください。

## Requirements

**ヘッダー:** xgamestreaming.h

**ライブラリ:** xgameruntime.lib

**サポートされているプラットフォーム:** Windows、XBOX One ファミリー本体および XBOX Series 本体

## Conceptual documentation

* [Game streaming latency compensation deep dive](/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)

## See also

[XGameStreaming](/reference/system/xgamestreaming/xgamestreaming_members)\
[Game Streaming Latency Compensation Overview](/build/core-features/common/game-streaming/game-streaming-latency-compensation-overview)


## Related topics

- [ゲーム ストリーミング レイテンシー補正の詳細](/ja-jp/build/core-features/common/game-streaming/game-streaming-latency-compensation-deep-dive.md)
- [XGameStreaming](/ja-jp/reference/system/xgamestreaming/xgamestreaming_members.md)
- [XGameStreamingGetAssociatedFrame](/ja-jp/reference/system/xgamestreaming/functions/xgamestreaminggetassociatedframe.md)
- [XGameStreamingGetLastFrameDisplayed](/ja-jp/reference/system/xgamestreaming/functions/xgamestreaminggetlastframedisplayed.md)
- [ゲーム ストリーミング レイテンシーの測定](/ja-jp/build/core-features/common/game-streaming/game-streaming-latency-measurement.md)