Skip to main content

XGameStreamingGetAssociatedFrame

사용되지 않음. 이 API는 2604 GDK 릴리스 기준으로 사용되지 않으며 향후 GDK 릴리스에서 제거될 예정입니다. 대체 API는 없습니다. 지연 시간을 고려한 게임 플레이 조정을 위해 타이틀은 대신 XGameStreamingGetStreamAddedLatency를 사용해야 합니다.
특정 입력 판독값에서 프레임 파이프라인 토큰을 가져옵니다.

구문

매개 변수

gamepadReading   _In_
형식: IGameInputReading*
쿼리되는 게임패드 판독값입니다. framePipelineToken   _Out_
형식: D3D12XBOX_FRAME_PIPELINE_TOKEN*
플레이어가 입력했을 때 클라이언트 장치에 표시되었던 프레임과 연결된 프레임 파이프라인 토큰입니다. 이 파이프라인 토큰은 게임에서 렌더링하여 클라이언트 장치로 전송된 시점의 PresentX 호출에 해당합니다.

반환값

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

잠재적 오류

설명

플레이어가 게임을 스트리밍하고 있을 때, 게임이 입력을 받을 당시 플레이어 장치에 어떤 특정 프레임이 표시되었는지에 따라 게임 동작을 변경해야 하는 경우 XGameStreamingGetAssociatedFrame을 활용할 수 있습니다. 이렇게 하면 게임은 현재 프레임이 아닌, 입력 당시 플레이어가 본 프레임을 기반으로 시뮬레이션 결정을 내릴 수 있습니다. XGameStreamingGetAssociatedFrame은 새 입력 판독값이 생성될 때 표시되는 프레임에 대한 정보만 게임에 제공할 수 있습니다. 플레이어가 입력을 하지 않은 상태에서 무엇이 표시되고 있었는지 게임이 판별해야 하는 경우, 게임은 XGameStreamingGetLastFrameDisplayed를 활용해야 합니다.

예제

요구 사항

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

개념 설명서

함께 보기

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