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

Details about the display of the streaming client device.

## 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;
};
```

### 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](https://docs.xbox.com/reference/system/xgamestreaming/functions/xgamestreaminggetdisplaydetails.md) 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](https://docs.xbox.com/reference/system/xgamestreaming/enums/xgamestreamingvideoflags.md)

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

## Remarks

This structure is returned by the [XGameStreamingGetDisplayDetails](https://docs.xbox.com/reference/system/xgamestreaming/functions/xgamestreaminggetdisplaydetails.md) 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.

## Requirements

**Header:** XGameStreaming.h

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

## See also

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


## Related topics

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