XNetworkingConnectivityHint
네트워크 연결 수준, 데이터 제한, 인터페이스 유형 및 네트워크 초기화 상태를 포함하여 네트워크의 현재 장치 전체 상태를 정의합니다.
구문
typedef struct XNetworkingConnectivityHint {
XNetworkingConnectivityLevelHint connectivityLevel;
XNetworkingConnectivityCostHint connectivityCost;
uint32_t ianaInterfaceType;
bool networkInitialized;
bool approachingDataLimit;
bool overDataLimit;
bool roaming;
} XNetworkingConnectivityHint
멤버
connectivityLevel
형식: XNetworkingConnectivityLevelHint
현재 장치에 대한 최선의 연결 수준입니다.
connectivityCost
형식: XNetworkingConnectivityCostHint
현재 장치의 데이터 제한에 대한 최선의 분류입니다.
ianaInterfaceType
형식: uint32_t
WinSock와 WinHTTP에서 인터넷에 연결하는 데 사용될 가능성이 높은 현재 인터페이스 유형입니다. IANA NDIS 인터페이스 유형 중 하나입니다.
networkInitialized
형식: bool
네트워크가 현재 초기화되었는지 판단합니다. 자세한 내용은 네트워크 정보 검색의 네트워크 초기화 섹션을 참조 하세요.
approachingDataLimit
형식: bool
장치가 데이터 제한 초과에 근접했는지 결정합니다.
overDataLimit
형식: bool
장치가 데이터 제한을 초과했는지 판단합니다.
roaming
형식: bool
장치가 로밍 중인지 판단합니다.
주석
네트워킹이나 보안 API를 사용하기 전에 networkInitialized 멤버가 true를 반환하는지 확인합니다.
참고 항목
초기화되지 않은 네트워크에서 XNetworking API를 사용하려고 하면 호출이 실패하고 예기치 않은 동작이 발생합니다.
이 구조는 XNetworkingGetConnectivityHint API에서 반환되고 레지스터 흐름에서 콜백을 합니다. Microsoft GDK(게임 개발 키트) 타이틀의 네트워크 정보는 네트워크 정보 검색을 참조하세요.
반환된 XNetworkingConnectivityHint 구조체(XNetworkingConnectivityHint::networkInitialized 필드는 예외)에 있는 필드는 힌트입니다. 장치가 장치의 네트워크 트래픽 요약을 바탕으로 네트워크 현재 상태를 추측하는 가장 좋은 방법입니다. 하지만 이러한 필드는 특정 타이틀 끝점과 연결됨을 의미하지는 않습니다. 네트워크 초기화를 기다린 후, WinSock 및/또는 WinHTTP를 사용하여 XNetworkingConnectivityHint::connectivityLevelHint 필드의 상태와 무관하게 끝점과 연결 형성을 시도하는 것이 좋습니다. 이러한 API가 나중에 실패한다면, 추가 UI 및 진단 보고에는 XNetworkingGetConnectivityHint API를 사용하는 것이 좋습니다. 그런 다음 네트워크 연결 수준이 변경될 때까지 기다린 후 다시 시도해야 합니다.
요구 사항
헤더: XNetworking.h
지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔