> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback

> XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback

# XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback

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

## 구문

```cpp theme={null}
void XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback(
         void* context,
         uint16_t preferredLocalUdpMultiplayerPort
)
```

### 매개 변수

*context*   \_In\_opt\_\
형식: void\*

[XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged](/reference/networking/xnetworking/functions/xnetworkingregisterpreferredlocaludpmultiplayerportchanged) 함수에 전달된 선택적 컨텍스트 포인터입니다.

*preferredLocalUdpMultiplayerPort*   \_In\_\
형식: uint16\_t

호스트 순서로 된 기본 설정 로컬 사용자 데이터그램 프로토콜(UDP) 멀티플레이어 포트에 대한 포인터입니다.

### 반환 값

형식: void

## 설명

`XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback`은 타이틀이 기본 설정 로컬 UDP 멀티플레이어 포트의 변경을 수신 대기할 때 호출됩니다. 타이틀이 실행되는 동안 기본 설정 로컬 UDP 멀티플레이어 포트가 변경되지 않도록 모든 노력을 기울입니다. 그러나 사용자의 외부 네트워크 조건이 변경되어 기존 소켓 흐름이 무효화되는 경우처럼 포트가 변경되는 것을 피할 수 없는 상황도 있습니다. 특히 [네트워크 연결 수준](/build/console-features/networking/initialization-connectivity-networking)이 변경되거나 타이틀의 일시 중단/재개 주기의 일부로 포트가 변경될 가능성이 높습니다.

자세한 내용은 [기본 설정 로컬 사용자 데이터그램 프로토콜(UDP) 멀티플레이어 포트 네트워킹 API](/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking)의 "기본 설정 로컬 UDP 멀티플레이어 포트의 변경 사항" 섹션을 참조하세요.

이 메서드는 호출 프로세스 내의 로컬 상태를 조사하고 빠르게 반환하므로, 시간에 민감한 컨텍스트에서 호출해도 안전합니다.

## 요구 사항

**헤더:** XNetworking.h

**라이브러리:** xgameruntime.lib

**지원 플랫폼:** Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 함께 보기

[XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged](/reference/networking/xnetworking/functions/xnetworkingregisterpreferredlocaludpmultiplayerportchanged)\
[XNetworking](/reference/networking/xnetworking/xnetworking_members)


## Related topics

- [XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged](/ko/reference/networking/xnetworking/functions/xnetworkingregisterpreferredlocaludpmultiplayerportchanged.md)
- [XNetworkingUnregisterPreferredLocalUdpMultiplayerPortChanged](/ko/reference/networking/xnetworking/functions/xnetworkingunregisterpreferredlocaludpmultiplayerportchanged.md)
- [XNetworking](/ko/reference/networking/xnetworking/xnetworking_members.md)
- [XNetworkingQueryPreferredLocalUdpMultiplayerPortAsync](/ko/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerportasync.md)
- [XNetworkingQueryPreferredLocalUdpMultiplayerPort](/ko/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerport.md)