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

Gets called when the preferred local multiplayer port is changed.

## Syntax

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

### Parameters

*context*   \_In\_opt\_\
Type: void\*

An optional context pointer that was passed to the [XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged](/reference/networking/xnetworking/functions/xnetworkingregisterpreferredlocaludpmultiplayerportchanged) function.

*preferredLocalUdpMultiplayerPort*   \_In\_\
Type: uint16\_t

Pointer to the preferred local User Datagram Protocol (UDP) multiplayer port in host order.

### Return value

Type: void

## Remarks

`XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback` gets called when the title listens for changes in the preferred local UDP multiplayer port. All attempts are made to ensure the preferred local UDP multiplayer port does not change while the title is running. However, there are unavoidable cases where the port will change due to the user's external network conditions changing and invalidating any existing socket flows. The port is especially likely to change when the [network connectivity level](/build/console-features/networking/initialization-connectivity-networking) changes, or as part of a title's suspend/resume cycle.

For more information, see the "Changes in the preferred local UDP multiplayer port" section of [Preferred local User Datagram Protocol (UDP) multiplayer port networking APIs](/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking).

This method interrogates the local state within the calling process and returns quickly, so it is safe to call from time-sensitive contexts.

## Requirements

**Header:** XNetworking.h

**Library:** xgameruntime.lib

**Supported platforms:** Windows, XBOX One family consoles and XBOX Series consoles

## See also

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


## Related topics

- [XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged](/reference/networking/xnetworking/functions/xnetworkingregisterpreferredlocaludpmultiplayerportchanged.md)
- [XNetworkingUnregisterPreferredLocalUdpMultiplayerPortChanged](/reference/networking/xnetworking/functions/xnetworkingunregisterpreferredlocaludpmultiplayerportchanged.md)
- [XNetworking](/reference/networking/xnetworking/xnetworking_members.md)
- [Preferred local UDP multiplayer port networking APIs](/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking.md)
- [XNetworkingQueryPreferredLocalUdpMultiplayerPortAsync](/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerportasync.md)
