> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XGameStreamingDisplayDetails

> XGameStreamingDisplayDetails

# XGameStreamingDisplayDetails

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

## 語法

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

### 成員

*preferredWidth*\
類型：uint32\_t

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

*preferredHeight*\
類型：uint32\_t

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

*safeArea*\
類型：RECT

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

*maxPixels*\
類型：uint32\_t

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

*maxWidth*\
類型：uint32\_t

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

*maxHeight*\
類型：uint32\_t

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

*flags*\
類型：[XGameStreamingVideoFlags](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/enums/xgamestreamingvideoflags.md)

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

## 備註

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

## 需求

**標頭：** XGameStreaming.h

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

## 另請參閱

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


## Related topics

- [XGameStreamingGetDisplayDetails](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminggetdisplaydetails.md)
- [XGameStreamingVideoFlags](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/enums/xgamestreamingvideoflags.md)
- [XGameStreamingSetResolution](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreamingsetresolution.md)
- [XGameStreaming (API 內容)](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/xgamestreaming_members.md)
- [遊戲串流自訂解析度的最佳做法](https://docs.xbox.com/zh-TW/build/core-features/common/game-streaming/game-streaming-custom-resolution-best-practices.md)