Skip to main content

XGameStreamingGetDisplayDetails

이 API는 지정한 클라이언트의 디스플레이 세부 정보를 반환합니다. 이를 사용하면 어떤 사용자 지정 종횡비로 렌더링할지 또는 DirectCapture를 사용하려면 어떤 해상도를 사용할지와 같은 정보에 근거한 결정을 내릴 수 있습니다.

구문

매개 변수

client   _In_
형식: XGameStreamingClientId
쿼리 대상 스트리밍 클라이언트입니다. maxSupportedPixels   _In_
형식: uint32_t
게임에서 지원하는 최대 픽셀 수입니다. widestSupportedAspectRatio   _In_
형식: float
게임에서 지원하는 가장 넓은 종횡비입니다. 가장 넓은 지원 해상도를 사용하여 width / height로 계산됩니다. tallestSupportedAspectRatio   _In_
형식: float
게임에서 지원하는 가장 높은 종횡비입니다. 가장 높은 지원 해상도를 사용하여 width / height로 계산됩니다. displayDetails   _Out_
형식: XGameStreamingDisplayDetails*
스트리밍 클라이언트의 디스플레이 세부 정보입니다.

반환 값

형식: HRESULT 성공하면 S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다.

잠재적 오류

오류 코드 목록은 오류 코드를 참조하세요.

설명

displayDetails의 데이터를 사용하여 게임 렌더링 해상도와 같은 게임의 여러 측면을 제어할 수 있으며, 중요한 정보나 UI가 상호 작용 가능한 위치에 놓이고 가려지지 않도록 배치 위치를 결정할 수 있습니다. displayDetails 구조체의 preferredWidthpreferredHeight는 스트리밍 클라이언트의 실제 디스플레이, 스트리밍 시스템 기반의 제한 사항, 그리고 게임이 제공한 매개 변수(maxSupportedPixels, widestSupportedAspectRatio, tallestSupportedAspectRatio)를 기반으로 결정됩니다. 게임 시작 시점에는 데이터를 사용할 수 없을 수 있으며, 클라이언트 연결 이벤트 시점에도 반드시 사용할 수 있는 것은 아니라는 점에 유의하세요. 따라서 게임에서는 이벤트나 폴링을 사용해야 합니다.

예제

요구 사항

헤더: xgamestreaming.h
라이브러리: xgameruntime.lib
지원 플랫폼: Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔

함께 보기

XGameStreaming XGameStreamingDisplayDetails XGameStreamingRegisterClientPropertiesChanged XGameStreamingSetResolution 사용자 지정 해상도 개요
마지막 수정일 2026년 8월 24일