XNetworkingGetConnectivityHint

현재 네트워크 연결 수준, 데이터 제한, 인터페이스 유형 및 네트워크 초기화 상태에 관한 디바이스 전체 정보를 쿼리합니다.

구문

HRESULT XNetworkingGetConnectivityHint(
         XNetworkingConnectivityHint* connectivityHint
)

매개 변수

connectivityHint _Out_
형식: XNetworkingConnectivityHint*

네트워크의 현재 장치 전체의 상태.

반환 값

형식: HRESULT

HRESULT 성공 또는 오류 코드입니다.

설명

이 함수는 네트워크 연결 수준, 데이터 한계, 유선 대비 무선 연결, 네트워크 초기화 등에 대한 장치의 전체 정보를 반환합니다. XNetworkingRegisterConnectivityHintChanged 및 XNetworkingUnregisterConnectivityHintChanged 기능을 사용하여 변경 내용을 수신할 수 있습니다.

반환된 XNetworkingConnectivityHint 구조체(XNetworkingConnectivityHint::networkInitialized 필드는 예외)에 있는 필드는 힌트입니다. 장치가 장치의 네트워크 트래픽 요약을 바탕으로 네트워크 현재 상태를 추측하는 가장 좋은 방법입니다. 하지만 이러한 필드는 특정 타이틀 끝점과 연결됨을 의미하지는 않습니다. 네트워크 초기화를 기다린 후, WinSock 및/또는 WinHTTP를 사용하여 XNetworkingConnectivityHint::connectivityLevelHint 필드의 상태와 무관하게 끝점과 연결 형성을 시도하는 것이 좋습니다. 이러한 API가 나중에 실패한다면, 추가 UI 및 진단 보고에는 XNetworkingGetConnectivityHint API를 사용하는 것이 좋습니다. 그런 다음 네트워크 연결 수준이 변경될 때까지 기다린 후 다시 시도해야 합니다.

네트워크 초기화에 대한 자세한 내용은 네트워크 초기화 및 연결을 참조합니다.

이 메서드는 호출 프로세스 내의 로컬 상태를 조사하고 빠르게 반환하므로 시간에 민감한 컨텍스트에서 호출해도 안전합니다.

요구 사항

헤더: XNetworking.h

라이브러리: xgameruntime.lib

지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔

참고 항목

XNetworkingRegisterConnectivityHintChanged
XNetworkingUnregisterConnectivityHintChanged
네트워크 초기화 상태 감지
XNetworking