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

Registra una función de devolución de llamada a la que llamar cuando cambia el puerto multijugador UDP local preferido.

## Sintaxis

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

### Parámetros

*queue*   \_In\_opt\_\
Tipo: XTaskQueueHandle

Cola en la que se registra la devolución de llamada. Se usan tanto el lado de trabajo como el lado de finalización de la cola.

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

Puntero de contexto opcional que se pasa a la devolución de llamada.

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

Función de devolución de llamada a la que llamar cuando cambia el puerto preferido.

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

Token que se usa para identificar la devolución de llamada al llamar a [XNetworkingUnregisterPreferredLocalUdpMultiplayerPortChanged](/reference/networking/xnetworking/functions/xnetworkingunregisterpreferredlocaludpmultiplayerportchanged).

### Valor devuelto

Tipo: HRESULT

Código HRESULT de éxito o de error.

## Comentarios

El registro para una notificación de cambio del puerto multijugador local preferido del protocolo de datagramas de usuario (UDP) siempre desencadena una devolución de llamada de notificación inicial.

Se realizan todos los intentos posibles para garantizar que el puerto multijugador UDP local preferido no cambie mientras se ejecuta un título. Sin embargo, hay casos inevitables en los que el puerto cambiará debido a que las condiciones de red externas del usuario cambian e invalidan los flujos de socket existentes. En concreto, es mucho más probable que el puerto cambie cuando cambia el [nivel de conectividad de red](/build/console-features/networking/initialization-connectivity-networking) o como parte de un ciclo de suspensión y reanudación del título.

Cuando cambia el puerto multijugador UDP local preferido, las conexiones entrantes adicionales de futuros pares pueden bloquearse en cualquier puerto preferido anterior. Esto puede no provocar un error en la capa de socket, pero es posible que el título deje de recibir paquetes en cualquier socket enlazado a cualquier puerto preferido anterior.

Los paquetes enviados hacia y desde los pares existentes pueden seguir funcionando, por lo que una notificación de cambio del puerto multijugador UDP local preferido puede no ser fatal para ninguna sesión de juego en curso.

Cuando se produce una notificación de cambio, el título debe migrar a un nuevo socket enlazado en el nuevo puerto preferido en cuanto sea posible sin interrumpir el juego existente. Si el título detecta una pérdida de conexión y reintenta la conexión del socket, el título siempre debe usar el puerto preferido más reciente.

Este método consulta el estado local dentro del proceso que realiza la llamada y se devuelve rápidamente, por lo que es seguro llamarlo desde contextos con restricciones de tiempo.

## Requisitos

**Encabezado:** XNetworking.h

**Biblioteca:** xgameruntime.lib

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

## Documentación conceptual

* [Puerto multijugador UDP preferido](/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking)

## Consulte también

[API de red del puerto multijugador UDP local preferido](/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking)\
[XNetworking](/reference/networking/xnetworking/xnetworking_members)


## Related topics

- [XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback](/es/reference/networking/xnetworking/functions/xnetworkingpreferredlocaludpmultiplayerportchangedcallback.md)
- [XNetworkingUnregisterPreferredLocalUdpMultiplayerPortChanged](/es/reference/networking/xnetworking/functions/xnetworkingunregisterpreferredlocaludpmultiplayerportchanged.md)
- [API de redes del puerto multijugador UDP local preferido](/es/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking.md)
- [XNetworkingQueryPreferredLocalUdpMultiplayerPortAsync](/es/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerportasync.md)
- [XNetworking](/es/reference/networking/xnetworking/xnetworking_members.md)