XNetworkingConnectivityHintChangedCallback
연결 힌트 구조체가 변경될 때 호출됩니다.구문
매개 변수
context _In_opt_형식: void* XNetworkingRegisterConnectivityHintChanged 함수에 전달된 선택적 컨텍스트 포인터입니다. connectivityHint _In_
형식: XNetworkingConnectivityHint* 새로운 디바이스 전체 연결 힌트 구조체입니다.
반환 값
형식: void설명
이 콜백 함수는 디바이스의 현재 연결에 관한 무언가가 변경될 때 호출됩니다. 이 함수에는 등록 함수가 호출될 때 전달된 컨텍스트 포인터가 포함됩니다. 이 콜백이 트리거된다고 해서 마지막으로 콜백이 트리거된 시점 이후에 무언가가 변경되었음을 보장하지는 않습니다.최선의 노력(best-effort)은 네트워크와 네트워크 연결 수준의 현재 디바이스 전체 상태에 적용됩니다. 네트워크 초기화는 최선의 노력이 아니라는 점을 유의해야 하며, 초기화가 드물게 발생하지 않을 수 있습니다.
XNetworkingConnectivityHint 구조체의 필드(XNetworkingConnectivityHint::networkInitialized 필드 제외)는 힌트입니다. 이는 디바이스의 네트워크 트래픽 요약을 기반으로 디바이스가 네트워크의 현재 상태에 대해 최선의 노력으로 추정한 값입니다. 중요한 점은 이러한 필드가 특정 타이틀 엔드포인트에 대한 연결 가능성을 나타내지는 않는다는 것입니다. 네트워크 초기화를 기다린 후에는 XNetworkingConnectivityHint::connectivityLevelHint 필드의 상태와 관계없이 WinSock 및/또는 WinHTTP를 사용해 엔드포인트에 연결을 시도할 것을 권장합니다. 이러한 API가 이후에 실패하면 추가 UI 및 진단 보고 목적으로 XNetworkingGetConnectivityHint API를 사용할 것을 권장합니다. 그런 다음 네트워크 연결 수준의 변경을 기다린 후 다시 시도해야 합니다.
이 메서드는 호출 프로세스 내의 로컬 상태를 조사하고 빠르게 반환하므로, 시간에 민감한 컨텍스트에서 호출해도 안전합니다.
요구 사항
헤더: XNetworking.h 라이브러리: xgameruntime.lib 지원 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔함께 보기
네트워크 정보 검색XNetworkingGetConnectivityHint
XNetworkingRegisterConnectivityHintChanged
XNetworkingUnregisterConnectivityHintChanged
XNetworking