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