XGameStreamingGetServerLocationName
ストリーミング サーバーのデータ センターの場所の名前を取得します。
構文
HRESULT XGameStreamingGetServerLocationName(
size_t serverLocationNameSize,
char* serverLocationName
)
パラメーター
serverLocationNameSize _In_
型: size_t
取得するデータ センターの場所の名前の最大サイズ。
serverLocationNameSize を取得するには、XGameStreamingGetServerLocationNameSize を呼び出す必要があります。
serverLocationName _Out_writes_z_(serverLocationNameSize)
型: char*
ストリーミング Xbox サーバーをホストしているデータ センターのある Azure リージョンの名前。
戻り値
型: HRESULT
成功した場合は S_OK を返し、それ以外の場合はエラー コードを返します。
返される可能性のあるエラー
| エラー コード | エラー値 | エラーの原因 |
|---|---|---|
| E_GAMESTREAMING_NOT_INITIALIZED | 0x89245400 | XGameStreaming ランタイムが初期化されていません。 他の API を呼び出す前に XGameStreamingInitialize を呼び出してください。 |
| E_NOT_SUFFICIENT_BUFFER | 0x7A | serverLocationSize のサイズが十分でないため、サーバーの場所の名前全体 (と終端の null 文字) を保持できません。 |
| E_GAMESTREAMING_NO_DATACENTER | 0x89245403 | 現在のコンピューターはデータ センターで実行されていません。 |
エラー コードの一覧については、「エラー コード」をご覧ください。
解説
この関数を呼び出す前に、XGameStreamingGetServerLocationNameSize を呼び出してサーバーの場所の名前のサイズを取得し、バッファーを割り当てることができます。
Azure PlayFab マルチプレイヤー サーバーによってホストされているゲーム サーバーに接続し、ゲーム サーバーの待機時間を最小限にしたい場合は、Azure リージョンを利用できます。
プレイヤーがホーム Xbox からコンソール ストリーミングを使ってゲームをストリーミングしている場合、E_GAMESTREAMING_NO_DATACENTER エラーが発生することがあります。 このエラーは、優先値を設定していない場合、Xbox 開発キットでも発生する可能性があります。
Xbox 開発キットでは、Developer Home の [ストリーミング] タブで、テスト中に返される serverLocationName を設定できます。
要件
ヘッダー: xgamestreaming.h
ライブラリ: xgameruntime.lib
サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体