XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged
기본 설정 로컬 UDP 멀티플레이어 포트가 변경될 때 호출할 콜백 함수를 등록합니다.구문
매개 변수
queue _In_opt_형식: XTaskQueueHandle 콜백을 등록할 큐입니다. 큐의 작업(work) 측과 완료(completion) 측이 모두 사용됩니다. context _In_opt_
형식: void* 콜백에 전달할 선택적 컨텍스트 포인터입니다. callback _In_
형식: XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback* 기본 설정 포트가 변경될 때 호출할 콜백 함수입니다. token _Out_
형식: XTaskQueueRegistrationToken* XNetworkingUnregisterPreferredLocalUdpMultiplayerPortChanged를 호출할 때 콜백을 식별하는 데 사용되는 토큰입니다.
반환 값
형식: HRESULT HRESULT 성공 또는 오류 코드입니다.설명
기본 설정 로컬 사용자 데이터그램 프로토콜(UDP) 멀티플레이어 포트 변경 알림에 등록하면 항상 초기 알림 콜백이 발생합니다. 타이틀이 실행되는 동안 기본 설정 로컬 UDP 멀티플레이어 포트가 변경되지 않도록 모든 노력을 기울입니다. 그러나 사용자의 외부 네트워크 조건이 변경되어 기존 소켓 흐름이 무효화되는 경우처럼 포트가 변경되는 것을 피할 수 없는 상황도 있습니다. 특히 네트워크 연결 수준이 변경되거나 타이틀의 일시 중단/재개 주기의 일부로 포트가 변경될 가능성이 훨씬 높습니다. 기본 설정 로컬 UDP 멀티플레이어 포트가 변경되면, 이전 기본 설정 포트에서 미래 피어로부터의 추가 인바운드 연결이 차단될 수 있습니다. 이로 인해 소켓 계층에서 오류가 발생하지 않을 수도 있지만, 타이틀이 결국 이전 기본 설정 포트에 바인딩된 소켓에서 패킷 수신을 중지할 수 있습니다. 기존 피어와 주고받는 패킷은 계속 작동할 수 있으므로, 기본 설정 로컬 UDP 멀티플레이어 포트 변경 알림이 진행 중인 게임 세션에 치명적이지 않을 수 있습니다. 변경 알림이 발생하면, 타이틀은 기존 게임 플레이를 방해하지 않고 가능한 한 빨리 새 기본 설정 포트에 바인딩된 새 소켓으로 마이그레이션해야 합니다. 타이틀이 연결 손실을 감지하고 소켓 연결을 재시도하는 경우, 항상 가장 최근의 기본 설정 포트를 사용해야 합니다. 이 메서드는 호출 프로세스 내의 로컬 상태를 조사하고 빠르게 반환하므로, 시간에 민감한 컨텍스트에서 호출해도 안전합니다.요구 사항
헤더: XNetworking.h 라이브러리: xgameruntime.lib 지원 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔개념 문서
함께 보기
기본 설정 로컬 UDP 멀티플레이어 포트 네트워킹 APIXNetworking