XNetworkingConnectivityHintChangedCallback

연결 힌트 구조가 변경되면 호출됩니다.

구문

void XNetworkingConnectivityHintChangedCallback(
         void* context,
         const XNetworkingConnectivityHint* connectivityHint
)

매개 변수

context _In_opt_
형식: void*

XNetworkingRegisterConnectivityHintChanged 함수에 전달되는 선택적인 컨텍스트 포인터입니다.

connectivityHint _In_
형식: XNetworkingConnectivityHint*

새로운 디바이스 전체의 연결 힌트 구조입니다.

반환 값

형식: void

설명

이 콜백 함수는 디바이스의 현재 연결이 변경된 경우 호출됩니다. 여기에는 등록 함수가 호출되었을 때 전달된 컨텍스트 포인터가 포함됩니다. 이 콜백이 트리거되었다고 해서 해당 콜백이 마지막으로 트리거된 이후에 반드시 변경 내용이 있었던 것은 아닙니다.

참고 항목

최상의 노력은 네트워크 및 네트워크 연결 수준의 현재 디바이스 전체 상태와 관련이 있습니다. 드물게 초기화가 발생하지 않을 수 있으므로 네트워크 초기화는 가장 좋은 방법이 아니라는 사실에 유의해야 합니다.

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

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

요구 사항

헤더: XNetworking.h

라이브러리: xgameruntime.lib

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

참고 항목

네트워크 정보 검색
XNetworkingGetConnectivityHint
XNetworkingRegisterConnectivityHintChanged
XNetworkingUnregisterConnectivityHintChanged
XNetworking