XGameStreamingSetResolution
스트림의 해상도를 설정합니다.구문
매개 변수
width _In_형식: uint32_t 스트림 해상도로 설정할 너비입니다. height _In_
형식: uint32_t 스트림 해상도로 설정할 높이입니다.
반환 값
형식: HRESULT 성공하면 S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다.잠재적 오류
오류 코드 목록은 오류 코드를 참조하세요.
설명
비표준 해상도를 사용하는 이 API는 XBOX Game Streaming 서버, XBOX Series X 개발 키트 및 XBOX Series S 테스트 키트에서만 성공합니다. 720p와 1080p 같은 표준 해상도는 하드웨어에 관계없이 성공합니다. 그 이유는 소매용 XBOX는 Remote Play를 통해서만 스트리밍할 수 있으며 TV로 여전히 비디오를 출력하고 있을 수 있어서 비표준 해상도를 사용하면 왜곡된 이미지가 생성될 수 있기 때문입니다. 너비와 높이의 최솟값은 640x360이어야 하며, 최댓값은 XGameStreamingGetDisplayDetails에서 검색할 수 있는 XGameStreamingDisplayDetails의maxWidth 및 maxHeight 필드에서 확인할 수 있습니다.
width * height로 계산되는 최대 픽셀 수는 인코더의 최댓값보다 작거나 같아야 합니다. 최댓값은 XGameStreamingGetDisplayDetails API를 사용하여 확인할 수 있습니다. 이 값은 향후 늘어날 수 있습니다.
width와 height는 8로 나누어져야 합니다.
이 API는 원하는 만큼 자주 호출할 수 있지만 스트림 해상도는 200ms마다 한 번만 변경할 수 있습니다. 해당 200ms 창 내에 발생한 호출 중 마지막 해상도가 창이 지난 후 적용됩니다.
이 API는 연결된 모든 클라이언트에 대해 스트림의 해상도를 설정한다는 점에 유의하세요. 즉, 여러 클라이언트가 연결되어 있을 때 게임에 가장 적합한 옵션이 무엇인지 결정하기 위해 특별히 고려해야 합니다. 표준 16:9 해상도를 사용하는 것을 의미할 수도 있고, 모든 클라이언트에 가장 잘 맞는 해상도를 찾는 것을 의미할 수도 있습니다.
스트림 해상도를 변경하면 ID3D12CommandQueue::PresentX에서 뷰 사각형 크기 조정이 수정됩니다. D3D12XBOX_PRESENT_PLANE_PARAMETERS.pDestPlacementBase의 0.0~1.0 크기 조정 계수는 표준 1920x1080이나 3840x2160 해상도가 아닌, XGameStreamingSetResolution에 전달된 너비와 높이를 참조합니다.
예제
요구 사항
헤더: xgamestreaming.h라이브러리: xgameruntime.lib
지원 플랫폼: Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔
함께 보기
XGameStreamingXGameStreamingDisplayDetails
XGameStreamingGetDisplayDetails
사용자 지정 해상도 개요
