XGameStreamingGetServerLocationName
스트리밍 서버의 데이터 센터 위치 이름을 얻습니다.
구문
HRESULT XGameStreamingGetServerLocationName(
size_t serverLocationNameSize,
char* serverLocationName
)
매개 변수
serverLocationNameSize _In_
형식: size_t
반환할 데이터 센터 위치 이름의 최대 크기
XGameStreamingGetServerLocationNameSize를 호출하여 serverLocationNameSize를 검색해야 합니다.
serverLocationName _Out_writes_z_(serverLocationNameSize)
형식: char*
스트리밍 Xbox 서버를 호스팅하는 데이터 센터가 있는 Azure 지역의 이름입니다.
값 반환
형식: HRESULT
성공한 경우 S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다.
잠재적인 오류
| 오류 코드 | 오류 값 | 오류 발생 원인 |
|---|---|---|
| E_GAMESTREAMING_NOT_INITIALIZED | 0x89245400 | XGameStreaming 런타임이 아직 초기화되지 않았습니다. 다른 API를 호출하기 전에 XGameStreamingInitialize를 호출합니다. |
| E_NOT_SUFFICIENT_BUFFER | 0x7A | serverLocationSize가 서버 위치의 전체 이름(및 종료 null 문자)을 보유 할만큼 충분히 크지 않습니다. |
| E_GAMESTREAMING_NO_DATACENTER | 0x89245403 | 현재 컴퓨터가 데이터 센터에서 실행되고 있지 않습니다. |
오류 코드 목록은 오류 코드를 참조하세요.
설명
이 함수를 호출하기 전에 XGameStreamingGetServerLocationNameSize를 호출하여 버퍼를 할당 할 수 있도록 서버 위치 이름의 크기를 가져올 수 있습니다.
게임이 Azure PlayFab 멀티 플레이어 서버에서 호스팅되는 게임 서버에 연결하고 게임 서버에 최소 대기 시간을 원하는 경우 Azure 지역을 활용할 수 있습니다.
E_GAMESTREAMING_NO_DATACENTER 오류는 플레이어가 본체 스트리밍을 사용하여 홈 Xbox에서 게임을 스트리밍할 때 발생할 수 있습니다. 이 오류는 재정의 값을 설정하지 않은 경우 Xbox 개발 키트에서도 발생할 수 있습니다.
Xbox 개발자 키트에서는 개발자 홈의 스트리밍 탭에서 테스트 중에 반환되어야하는 serverLocationName을(를) 설정할 수 있습니다.
요건
헤더: xgamestreaming.h
라이브러리: xgameruntime.lib
지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔