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