> ## 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](/reference/system/xgamestreaming/functions/xgamestreaminggetdisplaydetails) API 的 maxPixels 中的最小值。

*maxWidth*\
类型：uint32\_t

流式处理系统支持的最大宽度。

*maxHeight*\
类型：uint32\_t

流式处理系统支持的最大高度。

*flags*\
类型：[XGameStreamingVideoFlags](/reference/system/xgamestreaming/enums/xgamestreamingvideoflags)

流式处理客户端支持的视频相关功能集。

<a id="remarksSection" />

## 备注

此结构由 [XGameStreamingGetDisplayDetails](/reference/system/xgamestreaming/functions/xgamestreaminggetdisplaydetails) API 返回。因此，某些属性（如 *preferredWidth*、*preferredHeight* 和 *safeArea*）可能会根据传递给上述 API 的参数返回不同的结果。

<a id="requirementsSection" />

## 要求

**标头：** XGameStreaming.h

**支持的平台**：Windows、XBOX One 系列主机和 XBOX Series 主机

<a id="seealsoSection" />

## 另请参阅

[XGameStreaming](/reference/system/xgamestreaming/xgamestreaming_members)\
[XGameStreamingVideoFlags](/reference/system/xgamestreaming/enums/xgamestreamingvideoflags)\
[XGameStreamingGetDisplayDetails](/reference/system/xgamestreaming/functions/xgamestreaminggetdisplaydetails)\
[自定义分辨率概述](/build/core-features/common/game-streaming/game-streaming-custom-resolution-overview)


## Related topics

- [XGameStreamingGetDisplayDetails](/zh-CN/reference/system/xgamestreaming/functions/xgamestreaminggetdisplaydetails.md)
- [XGameStreamingVideoFlags](/zh-CN/reference/system/xgamestreaming/enums/xgamestreamingvideoflags.md)
- [XGameStreamingSetResolution](/zh-CN/reference/system/xgamestreaming/functions/xgamestreamingsetresolution.md)
- [XGameStreaming](/zh-CN/reference/system/xgamestreaming/xgamestreaming_members.md)
- [游戏串流自定义分辨率最佳实践](/zh-CN/build/core-features/common/game-streaming/game-streaming-custom-resolution-best-practices.md)