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 主機
