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

# XGameStreamingDisplayDetails

> XGameStreamingDisplayDetails

# XGameStreamingDisplayDetails

串流用戶端裝置顯示器的詳細資料。

<a id="syntaxSection" />

## 語法

```cpp theme={null}
struct XGameStreamingDisplayDetails
{
    uint32_t preferredWidth;
    uint32_t preferredHeight;
    RECT safeArea;
    uint32_t maxPixels;
    uint32_t maxWidth;
    uint32_t maxHeight;
    XGameStreamingVideoFlags flags;
};
```

<a id="membersSection" />

### 成員

*preferredWidth*\
類型：uint32\_t

為了在用戶端裝置上提供最佳體驗，遊戲解析度應轉譯的慣用寬度。

*preferredHeight*\
類型：uint32\_t

為了在用戶端裝置上提供最佳體驗，遊戲解析度應轉譯的慣用高度。

*safeArea*\
類型：RECT

慣用解析度中可安全轉譯的子區域。不安全區域是指螢幕遭到遮擋 (例如相機瀏海) 或無法互動 (例如某些裝置的邊緣) 的區域。矩形的值是以 `preferredWidth` 和 `preferredHeight` 為參考。

*maxPixels*\
類型：uint32\_t

支援的最大像素數。此值為串流系統所支援的最大像素數與傳遞給 [XGameStreamingGetDisplayDetails](/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminggetdisplaydetails) API 之 maxPixels 兩者中的較小值。

*maxWidth*\
類型：uint32\_t

串流系統支援的最大寬度。

*maxHeight*\
類型：uint32\_t

串流系統支援的最大高度。

*flags*\
類型：[XGameStreamingVideoFlags](/zh-TW/reference/system/xgamestreaming/enums/xgamestreamingvideoflags)

串流用戶端所支援的視訊相關功能集合。

<a id="remarksSection" />

## 備註

此結構由 [XGameStreamingGetDisplayDetails](/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminggetdisplaydetails) API 傳回。因此，*preferredWidth*、*preferredHeight* 和 *safeArea* 等部分屬性可能會因傳入上述 API 的參數不同而傳回不同的結果。

<a id="requirementsSection" />

## 需求

**標頭：** XGameStreaming.h

**支援的平台**：Windows、XBOX One 系列主機和 XBOX Series 主機

<a id="seealsoSection" />

## 另請參閱

[XGameStreaming](/zh-TW/reference/system/xgamestreaming/xgamestreaming_members)\
[XGameStreamingVideoFlags](/zh-TW/reference/system/xgamestreaming/enums/xgamestreamingvideoflags)\
[XGameStreamingGetDisplayDetails](/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminggetdisplaydetails)\
[自訂解析度概觀](/zh-TW/build/core-features/common/game-streaming/game-streaming-custom-resolution-overview)


## Related topics

- [XGameStreamingDisplayDetails](/reference/system/xgamestreaming/structs/xgamestreamingdisplaydetails.md)
- [XGameStreamingGetDisplayDetails](/reference/system/xgamestreaming/functions/xgamestreaminggetdisplaydetails.md)