Skip to main content

XGameStreamingGetLastFrameDisplayed

사용되지 않음(Deprecated). 이 API는 2604 GDK 릴리스부터 사용되지 않으며 향후 GDK 릴리스에서 제거될 예정입니다. 대체 API는 없습니다. 지연 시간을 고려한 게임 플레이 조정에는 XGameStreamingGetStreamAddedLatency를 대신 사용해야 합니다.
스트리밍 클라이언트의 화면에 가장 최근에 표시된 프레임의 프레임 파이프라인 토큰을 가져옵니다.

구문

매개 변수

client   _In_
형식: XGameStreamingClientId
쿼리 대상 스트리밍 클라이언트 장치의 ID입니다. framePipelineToken   _Out_
형식: D3D12XBOX_FRAME_PIPELINE_TOKEN*
클라이언트 장치에 마지막으로 표시된 프레임 파이프라인 토큰입니다.

반환 값

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

잠재적 오류

설명

플레이어가 게임을 스트리밍할 때, 특정 프레임이 사용자의 화면에 표시되었음을 확인한 뒤 게임 동작을 변경해야 하는 경우 XGameStreamingGetLastFrameDisplayed를 활용할 수 있습니다. 게임에서 이를 활용할 수 있는 예로는 다음과 같은 경우가 있습니다.
  • 시각적 타이머가 만료되었지만 플레이어가 만료 전에 아무 동작도 하지 않은 경우.
  • 적절한 시간 창 내에 동작이 이루어지지 않은 경우.
  • 플레이어가 경계를 벗어난 상태에서 계속 움직였고 복구를 위한 동작을 취하지 않은 경우.
XGameStreamingGetLastFrameDisplayed는 동작이 이루어졌어야 하지만 이루어지지 않은 시점을 파악하려는 경우에 사용해야 합니다. 게임이 플레이어가 입력을 수행했을 때 무엇이 표시되고 있었는지 판단해야 하는 경우에는 XGameStreamingGetAssociatedFrame을 사용해야 합니다.

예제

요구 사항

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

개념 문서

함께 보기

XGameStreamingGetAssociatedFrame
XGameStreaming
게임 스트리밍 지연 보정 개요
마지막 수정일 2026년 8월 24일