XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged
Registra uma função de retorno de chamada a ser chamada quando a porta multijogador UDP local preferencial for alterada.Sintaxe
Parâmetros
queue _In_opt_Tipo: XTaskQueueHandle Fila na qual registrar o retorno de chamada. Tanto o lado de trabalho quanto o lado de conclusão da fila são usados. context _In_opt_
Tipo: void* Ponteiro de contexto opcional a ser passado para o retorno de chamada. callback _In_
Tipo: XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback* Função de retorno de chamada a ser chamada quando a porta preferencial for alterada. token _Out_
Tipo: XTaskQueueRegistrationToken* Token usado para identificar o retorno de chamada ao chamar XNetworkingUnregisterPreferredLocalUdpMultiplayerPortChanged.
Valor retornado
Tipo: HRESULT Código de sucesso ou de erro HRESULT.Comentários
O registro para receber notificações de alteração da porta multijogador UDP (User Datagram Protocol) local preferencial sempre dispara um retorno de chamada de notificação inicial. Todas as tentativas são feitas para garantir que a porta multijogador UDP local preferencial não seja alterada enquanto um título estiver em execução. No entanto, há casos inevitáveis em que a porta será alterada devido a mudanças nas condições de rede externa do usuário que invalidam quaisquer fluxos de soquete existentes. Em particular, a probabilidade de a porta ser alterada é muito maior quando o nível de conectividade de rede é alterado ou como parte de um ciclo de suspensão/retomada do título. Quando a porta multijogador UDP local preferencial é alterada, conexões de entrada adicionais de pares futuros podem ser bloqueadas em qualquer porta preferencial anterior. Isso pode não causar uma falha na camada de soquete, mas o título pode eventualmente parar de receber pacotes em qualquer soquete associado a qualquer porta preferencial anterior. Os pacotes enviados de e para pares existentes podem continuar funcionando e, portanto, uma notificação de alteração da porta multijogador UDP local preferencial pode não ser fatal para qualquer sessão de jogo em andamento. Quando ocorrer uma notificação de alteração, o título deverá migrar para um novo soquete associado à nova porta preferencial na primeira oportunidade, sem interromper nenhuma jogabilidade existente. Se o título detectar uma perda de conexão e tentar novamente a conexão de soquete, ele deverá sempre usar a porta preferencial mais recente. Esse método consulta o estado local no processo de chamada e retorna rapidamente, portanto, é seguro chamá-lo a partir de contextos sensíveis ao tempo.Requisitos
Cabeçalho: XNetworking.h Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX SeriesDocumentação conceitual
Confira também
APIs de rede da porta multijogador UDP local preferencialXNetworking