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 구조체의 preferredWidth와 preferredHeight는 스트리밍 클라이언트의 실제 디스플레이, 스트리밍 시스템 기반의 제한 사항, 그리고 게임이 제공한 매개 변수(maxSupportedPixels, widestSupportedAspectRatio, tallestSupportedAspectRatio)를 기반으로 결정됩니다.
게임 시작 시점에는 데이터를 사용할 수 없을 수 있으며, 클라이언트 연결 이벤트 시점에도 반드시 사용할 수 있는 것은 아니라는 점에 유의하세요. 따라서 게임에서는 이벤트나 폴링을 사용해야 합니다.
예제
요구 사항
헤더: xgamestreaming.h라이브러리: xgameruntime.lib
지원 플랫폼: Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔
