XNetworkingQueryPreferredLocalUdpMultiplayerPortAsyncResult
XNetworkingQueryPreferredLocalUdpMultiplayerPortAsync 호출의 결과를 가져옵니다.구문
매개 변수
asyncBlock _Inout_형식: XAsyncBlock* XNetworkingQueryPreferredLocalUdpMultiplayerPortAsync 함수에 전달된 XAsyncBlock 구조체에 대한 포인터입니다. preferredLocalUdpMultiplayerPort _Out_
형식: uint16_t* 호스트 엔디안 순서로 된 기본 설정 로컬 사용자 데이터그램 프로토콜(UDP) 포트 번호에 대한 포인터입니다.
반환 값
형식: HRESULT HRESULT 성공 또는 오류 코드입니다.설명
이 함수는XAsyncBlock 구조체가 NetworkingQueryPreferredLocalUdpMultiplayerPortAsyncResult 함수에 전달되었을 때 비동기 멀티플레이어 트래픽을 위한 기본 설정 로컬 UDP 포트 번호를 가져옵니다. 검색되는 기본 설정 로컬 UDP 멀티플레이어 포트에 대한 자세한 내용은 기본 설정 로컬 사용자 데이터그램 프로토콜(UDP) 멀티플레이어 포트 네트워킹 API를 참조하세요. Microsoft Game Development Kit (GDK) 타이틀의 네트워크 정보에 대해서는 네트워크 정보 검색을 참조하세요.
반환된 기본 설정 로컬 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 함수를 사용해야 합니다.요구 사항
헤더: XNetworking.h 라이브러리: xgameruntime.lib 지원 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔함께 보기
XNetworkingQueryPreferredLocalUdpMultiplayerPortAsyncXNetworking