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

Details about the display of the streaming client device.

<a id="syntaxSection" />

## Syntax

```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" />

### Members

*preferredWidth*\
Type: uint32\_t

The preferred width that the resolution of the game should render at to provide the optimal experience on the client device.

*preferredHeight*\
Type: uint32\_t

The preferred height that the resolution of the game should render at to provide the optimal experience on the client device.

*safeArea*\
Type: RECT

The subarea of the preferred resolution where it is safe to render to. Unsafe areas are those where the screen is occluded like with a camera notch or uninteractable like the edges on some devices. The values of the rectangle is in reference to the `preferredWidth` and `preferredHeight`.

*maxPixels*\
Type: uint32\_t

The maximum number of pixels that is supported. This is the minimum of the maximum pixels supported by the streaming system and the maxPixels passed to the [XGameStreamingGetDisplayDetails](/reference/system/xgamestreaming/functions/xgamestreaminggetdisplaydetails) API.

*maxWidth*\
Type: uint32\_t

The maximum width that the streaming system supports.

*maxHeight*\
Type: uint32\_t

The maximum height that the streaming system supports.

*flags*\
Type: [XGameStreamingVideoFlags](/reference/system/xgamestreaming/enums/xgamestreamingvideoflags)

The set of video related features supported by the streaming client.

<a id="remarksSection" />

## Remarks

This structure is returned by the [XGameStreamingGetDisplayDetails](/reference/system/xgamestreaming/functions/xgamestreaminggetdisplaydetails) API. As a result some properties like the *preferredWidth*, *preferredHeight*, and *safeArea* may return different results depending on the parameters passed into the mentioned API.

<a id="requirementsSection" />

## Requirements

**Header:** XGameStreaming.h

**Supported Platforms**: Windows, XBOX One family consoles and XBOX Series consoles

<a id="seealsoSection" />

## See also

[XGameStreaming](/reference/system/xgamestreaming/xgamestreaming_members)\
[XGameStreamingVideoFlags](/reference/system/xgamestreaming/enums/xgamestreamingvideoflags)\
[XGameStreamingGetDisplayDetails](/reference/system/xgamestreaming/functions/xgamestreaminggetdisplaydetails)\
[Custom Resolution Overview](/build/core-features/common/game-streaming/game-streaming-custom-resolution-overview)


## Related topics

- [XGameStreamingGetDisplayDetails](/reference/system/xgamestreaming/functions/xgamestreaminggetdisplaydetails.md)
- [XGameStreaming](/reference/system/xgamestreaming/xgamestreaming_members.md)
- [XGameStreamingVideoFlags](/reference/system/xgamestreaming/enums/xgamestreamingvideoflags.md)
- [XGameStreamingSetResolution](/reference/system/xgamestreaming/functions/xgamestreamingsetresolution.md)
- [Best Practices for Game Streaming Custom Resolution](/build/core-features/common/game-streaming/game-streaming-custom-resolution-best-practices.md)