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

*maxWidth*\
类型：uint32\_t

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

*maxHeight*\
类型：uint32\_t

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

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

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

## 备注

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

## 要求

**标头：** XGameStreaming.h

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

## 另请参阅

[XGameStreaming](https://docs.xbox.com/zh-CN/reference/system/xgamestreaming/xgamestreaming_members.md)\
[XGameStreamingVideoFlags](https://docs.xbox.com/zh-CN/reference/system/xgamestreaming/enums/xgamestreamingvideoflags.md)\
[XGameStreamingGetDisplayDetails](https://docs.xbox.com/zh-CN/reference/system/xgamestreaming/functions/xgamestreaminggetdisplaydetails.md)\
[自定义分辨率概述](https://docs.xbox.com/zh-CN/build/core-features/common/game-streaming/game-streaming-custom-resolution-overview.md)


## Related topics

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