XNetworkingUnregisterPreferredLocalUdpMultiplayerPortChanged
Cancela o registro de uma função de retorno de chamada que foi registrada com XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged.Sintaxe
Parâmetros
token _In_Tipo: XTaskQueueRegistrationToken O token retornado por XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged. wait _In_
Tipo: bool Indica se deve bloquear até que todos os retornos de chamada pendentes sejam concluídos.
Valor retornado
Tipo: bool Retorna false se wait for false e a chamada de cancelamento de registro estiver pendente. Caso contrário, retorna true.Comentários
É seguro chamar esta função em um thread sensível ao tempo somente se o parâmetro wait for false. Para obter mais informações, confira Threads sensíveis ao tempo.
- O retorno de chamada associado ao token é removido do conjunto de retornos de chamada registrados.
- Se nenhum retorno de chamada estiver em execução para esse token de retorno de chamada, a chamada retornará true.
- Se houver retornos de chamada em execução e wait for true, a chamada será bloqueada até que o retorno de chamada em execução seja concluído.
- Se houver retornos de chamada em execução e wait for false, a chamada não será bloqueada, mas retornará false. Quando o retorno de chamada do token for concluído, o registro do token será cancelado automaticamente.
Esta função não deve ser chamada de dentro de um XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback se wait for true, pois isso causará um deadlock.
- Você pode bloquear no cancelamento de registro para garantir que seus retornos de chamada nunca sejam invocados após uma chamada de cancelamento de registro.
- Você pode optar por não bloquear. Se precisar garantir que seus retornos de chamada sejam concluídos antes de excluir dados, você poderá chamar esta função periodicamente com wait definido como false. Quando ela finalmente retornar true, todos os seus retornos de chamada estarão concluídos e você poderá excluir o estado.
- Se não importar para o seu retorno de chamada se ele está sendo invocado durante uma chamada de cancelamento de registro, você poderá passar false para wait e ignorar o valor retornado.
Requisitos
Cabeçalho: XNetworking.h Biblioteca: xgameruntime.lib Plataformas compatíveis: Windows, consoles da família XBOX One e consoles XBOX SeriesDocumentação conceitual
Confira também
XNetworkingQueryPreferredLocalUdpMultiplayerPortAPIs de rede da porta multijogador UDP local preferencial
XNetworking