XApuDisconnect
Desconecta-se do servidor de hardware e libera todos os recursos alocados durante XApuConnect.Sintaxe
Parâmetros
handle _In_Tipo: XApuHandle Identificador retornado pela chamada de XApuConnect.
Valor retornado
Tipo: HRESULT RetornaráS_OK se tiver êxito; caso contrário, retornará um código de erro.
Comentários
Além de desconectar do servidor de hardware, essa chamada também libera XApuConnectOutputParameters::baseData e fecha o identificador XApuConnectOutputParameters::resultReadyEvent. Se XApuDisconnect for chamado antes que todos os comandos enfileirados sejam processados, ele liberará todos os recursos e retornará o código de erro XAPU_E_PENDING_RESULTS. O chamador deve aguardar o resultado do último comando enfileirado antes de chamar XApuDisconnect; caso contrário, poderá ocorrer uma falha catastrófica no hardware, o que desabilitará outros clientes XAPU ativos. Não é recomendável chamar XapuConnect e XApuDisconnect com frequência para iniciar e parar fluxos, pois essas chamadas são demoradas e também podem levar a perdas de recursos devido à fragmentação da memória. Em vez disso, XapuConnect deve ser chamado uma vez na inicialização da sessão de streaming e, em seguida, XApuCommandType::Activate e XApuCommandType::Deactivate devem ser usados para iniciar e parar fluxos durante o streaming. No final da sessão de streaming, XApuDisconnect deve ser chamado. Isso vale para todos os clientes XAPU.Requisitos
Cabeçalho: xapu.h Biblioteca: xapu.lib Plataformas compatíveis: XBOX Series X|SDocumentação conceitual
Confira também
XApuConnectXAPU