Skip to main content

XGameStreamingShowTouchControlsWithStateUpdate

연결된 모든 스트리밍 클라이언트 장치가 터치 컨트롤 상태를 업데이트하고 지정한 터치 레이아웃을 표시하도록 요청합니다. 모든 상태 업데이트는 새 터치 레이아웃이 표시되기 전에 수행됩니다.

구문

매개 변수

layout   _In_opt_z_
형식: char*
표시할 터치 컨트롤 레이아웃의 이름 또는 표준 레이아웃을 표시하려면 nullptr입니다. operationCount   _In_
형식: size_t
전달되는 작업 배열의 크기입니다. operations   _In_reads_opt_(operationCount)
형식: XGameStreamingTouchControlsStateOperation*
요청되는 모든 상태 변수 업데이트의 배열입니다.

반환 값

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

잠재적 오류

설명

이 API는 게임에서 특정 터치 레이아웃을 표시해야 하며 렌더링에 영향을 줄 수 있는 일부 상태 업데이트가 필요할 때 사용해야 합니다. 새 터치 레이아웃에서 참조되는 변수의 상태를 업데이트하는 동시에 연결된 모든 스트리밍 클라이언트 장치에서 해당 터치 레이아웃으로 전환하려는 경우 이 API를 사용하세요. 이 API는 새 레이아웃이 표시되기 전에 모든 상태 업데이트가 이루어지도록 보장합니다. 특정 클라이언트에만 영향을 주려면 XGameStreamingShowTouchControlsWithStateUpdateOnClient를 사용하세요. 레이아웃만 변경하려는 경우 게임에서 대신 XGameStreamingShowTouchControlLayout을 사용해야 합니다. 상태 업데이트가 현재 레이아웃이나 다른 레이아웃에 영향을 줄 수 있고 특정 터치 레이아웃 변경과 관계없이 업데이트가 이루어져야 하는 경우 게임은 대신 XGameStreamingUpdateTouchControlsState를 사용해야 합니다.

예제

요구 사항

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

함께 보기

XGameStreaming
XGameStreamingTouchControlsStateOperationKind
XGameStreamingTouchControlsStateOperation
XGameStreamingTouchControlsStateValue
XGameStreamingShowTouchControlsWithStateUpdateOnClient
XGameStreamingUpdateTouchControlsState
XGameStreamingUpdateTouchControlsStateOnClient
마지막 수정일 2026년 8월 24일