XGameStreaming
초기화
게임 스트리밍 기능을 초기화하는 데 필요한 API입니다.| 함수 | 설명 |
|---|---|
| XGameStreamingInitialize | Game Streaming API를 초기화합니다. |
| XGameStreamingUninitialize | Game Streaming API를 초기화 해제합니다. |
클라이언트 속성
스트리밍 장치 또는 해당 게임 스트림의 속성을 가져오는 API입니다.함수
| 함수 | 설명 |
|---|---|
| XGameStreamingClientPropertiesChangedCallback | 스트리밍 장치의 속성이 변경되었을 때의 알림입니다. |
| XGameStreamingGetClientIPAddress | 사용되지 않음. 스트리밍 클라이언트의 IP 주소를 가져옵니다. 대신 XSTS 토큰 클레임을 사용하세요. |
| XGameStreamingGetDisplayDetails | 스트리밍 클라이언트의 디스플레이 세부 정보를 가져옵니다. |
| XGameStreamingGetSessionId | 스트리밍 클라이언트의 세션 ID를 가져옵니다. |
| XGameStreamingGetStreamPhysicalDimensions | 스트리밍 클라이언트에서 현재 렌더링되고 있는 비디오 스트림의 물리적 크기를 가져옵니다. |
| XGameStreamingGetTouchBundleVersion | 지정한 장치에서 현재 사용되고 있는 터치 적응 번들의 버전을 가져옵니다. |
| XGameStreamingGetTouchBundleVersionNameSize | 지정한 장치의 터치 적응 번들에 지정된 버전 이름의 크기를 가져옵니다. |
| XGameStreamingIsTouchInputEnabled | 클라이언트가 게임에 터치 입력을 전송할지 여부를 확인합니다. |
| XGameStreamingRegisterClientPropertiesChanged | 스트리밍 클라이언트 장치의 속성이 변경될 때 호출될 콜백을 등록합니다. |
| XGameStreamingUnregisterClientPropertiesChanged | 이전에 등록된 XGameStreamingClientPropertiesChangedCallback의 등록을 해제합니다. |
열거형
| 열거형 | 설명 |
|---|---|
| XGameStreamingClientProperty | 클라이언트 스트리밍 장치에 대해 쿼리할 수 있는 속성입니다. |
| XGameStreamingVideoFlags | 클라이언트 스트리밍 장치가 지원할 수 있는 비디오 기능입니다. |
구조체
| 구조체 | 설명 |
|---|---|
| XGameStreamingDisplayDetails | 스트리밍 클라이언트 장치의 디스플레이에 대한 세부 정보입니다. |
연결 상태
스트리밍 클라이언트 장치의 연결 상태를 관리하는 데 필요한 API입니다.함수
| 함수 | 설명 |
|---|---|
| XGameStreamingConnectionStateChangedCallback | 연결된 스트리밍 클라이언트의 상태가 변경될 때마다 호출되는 콜백 함수입니다. |
| XGameStreamingGetClientCount | 현재 연결된 스트리밍 장치의 수입니다. |
| XGameStreamingGetClients | 현재 연결된 각 클라이언트의 식별자를 가져옵니다. |
| XGameStreamingGetConnectionState | 지정한 장치의 현재 연결 상태를 가져옵니다. |
| XGameStreamingIsStreaming | 게임이 현재 스트리밍되고 있는지 여부를 확인합니다. |
| XGameStreamingRegisterConnectionStateChanged | 스트리밍 클라이언트 장치의 연결 상태가 변경될 때 호출될 콜백을 등록합니다. |
| XGameStreamingUnregisterConnectionStateChanged | 이전에 등록된 XGameStreamingConnectionStateChangedCallback의 등록을 해제합니다. |
열거형
| 열거형 | 설명 |
|---|---|
| XGameStreamingConnectionState | 스트리밍 클라이언트 장치의 연결 상태입니다. |
지연 시간
스트리밍 지연 시간에 맞게 게임 플레이를 조정하는 API입니다.함수
| 함수 | 설명 |
|---|---|
| XGameStreamingGetStreamAddedLatency | 최근 평균 스트리밍 관련 지연 시간을 가져옵니다. |
| XGameStreamingGetLastFrameDisplayed | 사용되지 않음. 스트리밍 클라이언트의 화면에 가장 최근에 표시된 프레임의 프레임 파이프라인 토큰을 가져옵니다. |
| XGameStreamingGetAssociatedFrame | 사용되지 않음. 특정 입력 판독값에서 프레임 파이프라인 토큰을 가져옵니다. |
서버 위치
게임이 스트리밍되고 있는 위치에 액세스하는 API입니다.함수
| 함수 | 설명 |
|---|---|
| XGameStreamingGetServerLocationName | 스트리밍 서버의 데이터 센터 위치를 가져옵니다. |
| XGameStreamingGetServerLocationNameSize | 스트리밍 서버의 데이터 센터 위치 이름의 크기를 가져옵니다. |
터치 적응
해당 스트리밍 클라이언트에 노출될 터치 컨트롤러 레이아웃을 관리하는 API입니다.함수
| 함수 | 설명 |
|---|---|
| XGameStreamingGetGamepadPhysicality | 특정 게임패드 판독값에서 입력 물리성 매핑을 가져옵니다. |
| XGameStreamingHideTouchControls | 연결된 모든 스트리밍 클라이언트 장치에서 터치 레이아웃이 표시되고 있는 경우 이를 숨기도록 요청합니다. |
| XGameStreamingHideTouchControlsOnClient | 지정한 스트리밍 클라이언트 장치에서 터치 레이아웃이 표시되고 있는 경우 이를 숨기도록 요청합니다. |
| XGameStreamingShowTouchControlLayout | 연결된 모든 스트리밍 클라이언트 장치에서 지정한 터치 레이아웃을 표시하도록 요청합니다. |
| XGameStreamingShowTouchControlLayoutOnClient | 연결된 지정한 스트리밍 클라이언트 장치에 지정한 터치 레이아웃을 표시하도록 요청합니다. |
| XGameStreamingShowTouchControlsWithStateUpdate | 연결된 모든 스트리밍 클라이언트 장치가 터치 컨트롤 상태를 업데이트한 후 지정한 터치 레이아웃을 표시하도록 요청합니다. |
| XGameStreamingShowTouchControlsWithStateUpdateOnClient | 지정한 스트리밍 클라이언트 장치가 터치 컨트롤 상태를 업데이트한 후 지정한 터치 레이아웃을 표시하도록 요청합니다. |
| XGameStreamingUpdateTouchControlsState | 연결된 모든 스트리밍 클라이언트 장치의 터치 컨트롤 상태를 업데이트합니다. |
| XGameStreamingUpdateTouchControlsStateOnClient | 지정한 스트리밍 클라이언트 장치의 터치 컨트롤 상태를 업데이트합니다. |
열거형
| 열거형 | 설명 |
|---|---|
| XGameStreamingGamepadPhysicality | 표준 XBOX 무선 컨트롤러의 모든 버튼, 스틱 및 트리거에 대한 물리성 매핑입니다. 주어진 버튼/스틱/트리거에 대해 물리성은 알 수 없음, 물리적, 가상 또는 둘 다일 수 있습니다. |
| XGameStreamingTouchControlsStateOperationKind | 터치 컨트롤 레이아웃 상태를 업데이트할 때 수행할 수 있는 작업입니다. |
| XGameStreamingTouchControlsStateValueKind | 터치 레이아웃과 연결된 상태의 형식을 지정합니다. |
구조체
| 구조체 | 설명 |
|---|---|
| XGameStreamingTouchControlsStateOperation | 작업, 특정 변수의 경로, 적용될 값을 지정합니다. |
| XGameStreamingTouchControlsStateValue | 터치 컨트롤 상태의 특정 요소에 대한 형식과 값을 제공합니다. |
해상도
스트림의 해상도를 관리하는 API입니다.함수
| 함수 | 설명 |
|---|---|
| XGameStreamingSetResolution | 비디오 스트림의 해상도를 설정합니다. |
오류 코드
XGameStreaming API에서 다음 오류 코드가 반환될 수 있습니다. 전체 목록은 오류 코드를 참조하세요.| 코드 | 값 | 설명 |
|---|---|---|
| E_GAMESTREAMING_NOT_INITIALIZED | 0x89245400 | XGameStreaming 런타임이 초기화되지 않았습니다. 다른 API를 호출하기 전에 XGameStreamingInitialize를 호출하세요. |
| E_GAMESTREAMING_CLIENT_NOT_CONNECTED | 0x89245401 | 지정한 클라이언트가 연결되어 있지 않습니다. |
| E_GAMESTREAMING_NO_DATA | 0x89245402 | 요청한 데이터를 사용할 수 없습니다. 데이터는 나중에 사용할 수 있게 될 수 있습니다. |
| E_GAMESTREAMING_NO_DATACENTER | 0x89245403 | 현재 컴퓨터가 데이터 센터에서 실행되고 있지 않습니다. |
| E_GAMESTREAMING_NOT_STREAMING_CONTROLLER | 0x89245404 | 현재 판독값이 스트리밍 컨트롤러에서 온 것이 아닙니다. |