Skip to main content

XGameStreamingSetResolution

ストリームの解像度を設定します。

Syntax

Parameters

width   _In_
型: uint32_t
ストリームの解像度に設定する幅。 height   _In_
型: uint32_t
ストリームの解像度に設定する高さ。

Return value

型: HRESULT 成功した場合は S_OK を返します。それ以外の場合はエラー コードを返します。

想定されるエラー

エラー コードの一覧については、Error Codes を参照してください。

Remarks

非標準の解像度でのこの API は、XBOX Game Streaming サーバー、XBOX Series X Dev Kit、および XBOX Series S Test Kit でのみ成功します。720p や 1080p などの標準解像度は、ハードウェアに関係なく成功します。理由は、リテールの XBOX はリモート プレイ経由でのみストリーミングでき、テレビへの映像出力が継続する可能性があるため、非標準の解像度を使用すると歪んだ映像になるからです。 幅と高さは最低 640x360 であり、最大値は XGameStreamingGetDisplayDetails から取得できる XGameStreamingDisplayDetailsmaxWidth および maxHeight フィールドで確認できます。 width * height から計算される最大ピクセル数は、エンコーダーの上限以下である必要があります。上限は XGameStreamingGetDisplayDetails API を使用して確認できます。この値は将来引き上げられる可能性があります。 widthheight は 8 で割り切れる必要があります。 この API は必要な頻度で呼び出せますが、ストリームの解像度は 200ms ごとに 1 回しか変更できません。その 200ms のウィンドウ内で行われたすべての呼び出しのうち、最後の解像度がウィンドウの経過後に適用されます。 この API は接続されているすべてのクライアントのストリームの解像度を設定する点に注意してください。つまり、複数のクライアントが接続されている場合にゲームにとって最適な選択肢を判断するには、特別な考慮が必要です。標準の 16:9 の解像度を使用する場合もあれば、すべてのクライアントに最も適した解像度を探そうとする場合もあります。
ストリームの解像度を変更すると、ID3D12CommandQueue::PresentX でのビュー矩形のスケーリングが変更されます。D3D12XBOX_PRESENT_PLANE_PARAMETERS.pDestPlacementBase の 0.0~1.0 のスケール係数は、通常参照される標準的な 1920x1080 または 3840x2160 の解像度ではなく、XGameStreamingSetResolution に渡された高さと幅を参照するようになります。

Example

Requirements

ヘッダー: xgamestreaming.h
ライブラリ: xgameruntime.lib
サポートされているプラットフォーム: Windows、XBOX One ファミリー本体および XBOX Series 本体

See also

XGameStreaming
XGameStreamingDisplayDetails
XGameStreamingGetDisplayDetails
Custom Resolution Overview
最終更新日 2026年8月24日