XNetworkingGetConnectivityHint
현재 네트워크 연결 수준, 데이터 제한, 인터페이스 유형 및 네트워크 초기화 상태에 대한 디바이스 전체 정보를 쿼리합니다.구문
매개 변수
connectivityHint _Out_형식: XNetworkingConnectivityHint* 네트워크의 현재 디바이스 전체 상태입니다.
반환 값
형식: HRESULT HRESULT 성공 또는 오류 코드입니다.설명
이 함수는 네트워크 연결 수준, 데이터 제한, 유선/무선 연결 여부, 그리고 네트워크가 초기화되었는지 여부에 대한 디바이스 전체 정보를 반환합니다. 변경 사항은 XNetworkingRegisterConnectivityHintChanged 및 XNetworkingUnregisterConnectivityHintChanged 함수를 사용해 수신 대기할 수 있습니다. 반환된XNetworkingConnectivityHint 구조체의 필드(XNetworkingConnectivityHint::networkInitialized 필드 제외)는 힌트입니다. 이는 디바이스의 네트워크 트래픽 요약을 기반으로 디바이스가 네트워크의 현재 상태에 대해 최선의 노력으로 추정한 값입니다. 중요한 점은 이러한 필드가 특정 타이틀 엔드포인트에 대한 연결 가능성을 나타내지는 않는다는 것입니다. 네트워크 초기화를 기다린 후에는 XNetworkingConnectivityHint::connectivityLevelHint 필드의 상태와 관계없이 WinSock 및/또는 WinHTTP를 사용해 엔드포인트에 연결을 시도할 것을 권장합니다. 이러한 API가 이후에 실패하면 추가 UI 및 진단 보고 목적으로 XNetworkingGetConnectivityHint API를 사용할 것을 권장합니다. 그런 다음 네트워크 연결 수준의 변경을 기다린 후 다시 시도해야 합니다.
네트워크 초기화에 대한 자세한 내용은 네트워크 초기화 및 연결을 참조하세요.
이 메서드는 호출 프로세스 내의 로컬 상태를 조사하고 빠르게 반환하므로, 시간에 민감한 컨텍스트에서 호출해도 안전합니다.
요구 사항
헤더: XNetworking.h 라이브러리: xgameruntime.lib 지원 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔함께 보기
XNetworkingRegisterConnectivityHintChangedXNetworkingUnregisterConnectivityHintChanged
네트워크 초기화 상태 감지
XNetworking