Skip to main content

​
XNetworkingQueryPreferredLocalUdpMultiplayerPort

멀티플레이어 트래픽에 사용할 기본 설정 로컬 UDP 포트를 가져옵니다.

​
구문

​
매개 변수

preferredLocalUdpMultiplayerPort   _Out_
형식: uint16_t* 기본 설정 로컬 UDP 멀티플레이어 포트인 사용자 데이터그램 프로토콜(UDP) 포트 번호(호스트 엔디안 형식)에 대한 포인터입니다.

​
반환 값

형식: HRESULT HRESULT 성공 또는 오류 코드입니다.

​
설명

이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
반환된 기본 설정 로컬 UDP 멀티플레이어 포트는 원격 디바이스가 로컬 디바이스에 연결하기 위해 사용할 수 있는 공용 포트가 아니라, 이후 소켓 bind 작업에서 사용될 로컬 포트입니다. 이는 멀티플레이어 실시간 타이틀 네트워킹 흐름을 특별히 대상으로 하므로 TCP 또는 HTTP 트래픽이 아닌 UDP 트래픽에만 의미가 있습니다. 이 포트의 기본값은 UDP 3074이지만, 게이밍 트래픽에 적합하지 않다고 판단될 때의 자동 폴백과, 사용자가 XBOX 네트워크 설정 문제 해결사를 통해 설정할 수 있는 수동 재정의가 모두 존재합니다. 이 포트의 네트워크 동작은 사용자에게 표시되는 NAT 유형인 엄격(strict), 보통(moderate), 개방(open)을 결정하는 데 사용됩니다. 이 포트는 XBOX 파티 채팅, XBOX 네트워크 문제 해결사, 온라인 XBOX Live 문제 해결 설명서, CSS 문제 해결 흐름에서 사용되며, 사용자가 홈 라우터에서 수동으로 구성하는 경우가 많습니다. 반환된 포트는 인바운드 및 아웃바운드 패킷을 허용하도록 UPnP를 통해 사용자의 홈 라우터에 이미 구성되어 있습니다. 이 포트는 다른 모든 포트와 동일하게 취급되어야 하며 Windows Sockets (Winsock) API와 함께 사용되어야 합니다. 타이틀은 이 포트에서 IPv4와 IPv6 모두에 바인딩하거나 이중 스택 소켓을 사용해야 하며, INADDR_ANY/in6addr_any 주소에 바인딩해야 합니다.
포트는 이 함수에서 호스트 엔디안 순서로 반환됩니다. sockaddr_in::sin_port와 sockaddr_in6::sin6_port 필드는 모두 네트워크 엔디안 순서입니다. 반환된 포트를 bind 함수에 전달할 때 엔디안을 변환하려면 htons 함수를 사용하세요.
반환된 포트로 원하는 서버 또는 피어와의 성공적인 소켓 연결을 확립할 수 있다고 보장되지는 않습니다. 일반적인 타이틀 재시도 및 폴백 로직을 수행해야 합니다. 타이틀은 필요한 경우 보안 계층과 필요한 네트워크 주소 변환(NAT) 감지 및 순회 구현을 제공해야 합니다. 성공적인 연결 가능성을 최대화하기 위해, 타이틀은 주요 게임 트래픽 소켓 흐름에 이 포트를 사용하는 것이 강력히 권장됩니다. Microsoft Azure PlayFab Party 라이브러리는 기본적으로 이 포트를 사용합니다. PlayFab Party 라이브러리를 명시적으로 다른 포트를 사용하도록 구성하지 않는 한, 기본 설정 로컬 UDP 멀티플레이어 포트에 직접 바인딩하지 마세요.

​
요구 사항

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

​
개념 문서

​
함께 보기

기본 설정 로컬 UDP 멀티플레이어 포트 네트워킹 API
Windows Sockets (Winsock)
Microsoft Azure PlayFab Party
XNetworking
마지막 수정일 2026년 8월 24일