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 콘솔
함께 보기
XGameStreamingXGameStreamingTouchControlsStateOperationKind
XGameStreamingTouchControlsStateOperation
XGameStreamingTouchControlsStateValue
XGameStreamingShowTouchControlsWithStateUpdateOnClient
XGameStreamingUpdateTouchControlsState
XGameStreamingUpdateTouchControlsStateOnClient
