> ## 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](/ko/reference/system/xgamestreaming/functions/xgamestreaminggetdisplaydetails.md)
- [XGameStreamingVideoFlags](/ko/reference/system/xgamestreaming/enums/xgamestreamingvideoflags.md)
- [XGameStreamingSetResolution](/ko/reference/system/xgamestreaming/functions/xgamestreamingsetresolution.md)
- [XGameStreaming](/ko/reference/system/xgamestreaming/xgamestreaming_members.md)
- [게임 스트리밍 사용자 지정 해상도 모범 사례](/ko/build/core-features/common/game-streaming/game-streaming-custom-resolution-best-practices.md)