Skip to main content

XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback

기본 설정 로컬 멀티플레이어 포트가 변경될 때 호출됩니다.

구문

매개 변수

context   _In_opt_
형식: void*
XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged 함수에 전달된 선택적 컨텍스트 포인터입니다. preferredLocalUdpMultiplayerPort   _In_
형식: uint16_t
호스트 순서로 된 기본 설정 로컬 사용자 데이터그램 프로토콜(UDP) 멀티플레이어 포트에 대한 포인터입니다.

반환 값

형식: void

설명

XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback은 타이틀이 기본 설정 로컬 UDP 멀티플레이어 포트의 변경을 수신 대기할 때 호출됩니다. 타이틀이 실행되는 동안 기본 설정 로컬 UDP 멀티플레이어 포트가 변경되지 않도록 모든 노력을 기울입니다. 그러나 사용자의 외부 네트워크 조건이 변경되어 기존 소켓 흐름이 무효화되는 경우처럼 포트가 변경되는 것을 피할 수 없는 상황도 있습니다. 특히 네트워크 연결 수준이 변경되거나 타이틀의 일시 중단/재개 주기의 일부로 포트가 변경될 가능성이 높습니다. 자세한 내용은 기본 설정 로컬 사용자 데이터그램 프로토콜(UDP) 멀티플레이어 포트 네트워킹 API의 “기본 설정 로컬 UDP 멀티플레이어 포트의 변경 사항” 섹션을 참조하세요. 이 메서드는 호출 프로세스 내의 로컬 상태를 조사하고 빠르게 반환하므로, 시간에 민감한 컨텍스트에서 호출해도 안전합니다.

요구 사항

헤더: XNetworking.h 라이브러리: xgameruntime.lib 지원 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

함께 보기

XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged
XNetworking
마지막 수정일 2026년 8월 24일