> ## 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.

# XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged

> XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged

# XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged

기본 설정 로컬 UDP 멀티플레이어 포트가 변경될 때 호출할 콜백 함수를 등록합니다.

## 구문

```cpp theme={null}
HRESULT XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged(
         XTaskQueueHandle queue,
         void* context,
         XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback* callback,
         XTaskQueueRegistrationToken* token
)
```

### 매개 변수

*queue*   \_In\_opt\_\
형식: XTaskQueueHandle

콜백을 등록할 큐입니다. 큐의 작업(work) 측과 완료(completion) 측이 모두 사용됩니다.

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

콜백에 전달할 선택적 컨텍스트 포인터입니다.

*callback*   \_In\_\
형식: [XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback](/reference/networking/xnetworking/functions/xnetworkingpreferredlocaludpmultiplayerportchangedcallback)\*

기본 설정 포트가 변경될 때 호출할 콜백 함수입니다.

*token*   \_Out\_\
형식: [XTaskQueueRegistrationToken](/reference/system/xtaskqueue/structs/xtaskqueueregistrationtoken)\*

[XNetworkingUnregisterPreferredLocalUdpMultiplayerPortChanged](/reference/networking/xnetworking/functions/xnetworkingunregisterpreferredlocaludpmultiplayerportchanged)를 호출할 때 콜백을 식별하는 데 사용되는 토큰입니다.

### 반환 값

형식: HRESULT

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

## 설명

기본 설정 로컬 사용자 데이터그램 프로토콜(UDP) 멀티플레이어 포트 변경 알림에 등록하면 항상 초기 알림 콜백이 발생합니다.

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

기본 설정 로컬 UDP 멀티플레이어 포트가 변경되면, 이전 기본 설정 포트에서 미래 피어로부터의 추가 인바운드 연결이 차단될 수 있습니다. 이로 인해 소켓 계층에서 오류가 발생하지 않을 수도 있지만, 타이틀이 결국 이전 기본 설정 포트에 바인딩된 소켓에서 패킷 수신을 중지할 수 있습니다.

기존 피어와 주고받는 패킷은 계속 작동할 수 있으므로, 기본 설정 로컬 UDP 멀티플레이어 포트 변경 알림이 진행 중인 게임 세션에 치명적이지 않을 수 있습니다.

변경 알림이 발생하면, 타이틀은 기존 게임 플레이를 방해하지 않고 가능한 한 빨리 새 기본 설정 포트에 바인딩된 새 소켓으로 마이그레이션해야 합니다. 타이틀이 연결 손실을 감지하고 소켓 연결을 재시도하는 경우, 항상 가장 최근의 기본 설정 포트를 사용해야 합니다.

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

## 요구 사항

**헤더:** XNetworking.h

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

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

## 개념 문서

* [기본 설정 UDP 멀티플레이어 포트](/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking)

## 함께 보기

[기본 설정 로컬 UDP 멀티플레이어 포트 네트워킹 API](/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking)\
[XNetworking](/reference/networking/xnetworking/xnetworking_members)


## Related topics

- [XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback](/ko/reference/networking/xnetworking/functions/xnetworkingpreferredlocaludpmultiplayerportchangedcallback.md)
- [XNetworkingUnregisterPreferredLocalUdpMultiplayerPortChanged](/ko/reference/networking/xnetworking/functions/xnetworkingunregisterpreferredlocaludpmultiplayerportchanged.md)
- [선호 로컬 UDP 멀티플레이어 포트 네트워킹 API](/ko/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking.md)
- [XNetworkingQueryPreferredLocalUdpMultiplayerPortAsync](/ko/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerportasync.md)
- [XNetworking](/ko/reference/networking/xnetworking/xnetworking_members.md)