Skip to main content

XGameStreamingGetDisplayDetails

此 API 會傳回指定用戶端的顯示詳細資料。這可用來做出明智的決策,例如要以何種自訂外觀比例進行轉譯,或要使用何種解析度來啟用 DirectCapture。

語法

參數

client   _In_
類型:XGameStreamingClientId
要查詢的串流用戶端。 maxSupportedPixels   _In_
類型:uint32_t
遊戲支援的像素數目上限。 widestSupportedAspectRatio   _In_
類型:float
遊戲支援的最寬外觀比例。這是使用支援的最寬解析度,以寬度 / 高度計算而得。 tallestSupportedAspectRatio   _In_
類型:float
遊戲支援的最高外觀比例。這是使用支援的最高解析度,以寬度 / 高度計算而得。 displayDetails   _Out_
類型:XGameStreamingDisplayDetails*
串流用戶端的顯示詳細資料。

傳回值

類型:HRESULT 如果成功,則傳回 S_OK;否則傳回錯誤碼。

可能的錯誤

如需錯誤碼清單,請參閱錯誤碼。

備註

displayDetails 中的資料可用來決定遊戲的各個層面,例如遊戲的轉譯解析度,以及要將重要資訊或 UI 放在何處,以確保其可供互動且不會被遮住。 displayDetails 結構中的 preferredWidth 和 preferredHeight 是根據串流用戶端上的實際顯示器、串流系統的限制,以及遊戲提供的參數 (maxSupportedPixels、widestSupportedAspectRatio、tallestSupportedAspectRatio) 而定。 請記住,資料在遊戲啟動時可能無法使用,在用戶端連線事件發生時也不一定可供使用,因此遊戲應使用事件或輪詢。

範例

需求

標頭: xgamestreaming.h
程式庫: xgameruntime.lib
支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

另請參閱

XGameStreaming XGameStreamingDisplayDetails XGameStreamingRegisterClientPropertiesChanged XGameStreamingSetResolution 自訂解析度概觀
Last modified on October 6, 2026