XApuDisconnect
Se desconecta del servidor de hardware y libera todos los recursos asignados durante XApuConnect.Sintaxis
Parámetros
handle _In_Tipo: XApuHandle Identificador devuelto al llamar a XApuConnect.
Valor devuelto
Tipo: HRESULT DevuelveS_OK si se ejecuta correctamente; de lo contrario, devuelve un código de error.
Comentarios
Además de desconectarse del servidor de hardware, esta llamada también liberará XApuConnectOutputParameters::baseData y cerrará el identificador de XApuConnectOutputParameters::resultReadyEvent. Si se llama a XApuDisconnect antes de que se procesen todos los comandos en cola, liberará todos los recursos y devolverá este código de error XAPU_E_PENDING_RESULTS. El autor de la llamada debe esperar el resultado del último comando puesto en cola antes de llamar a XApuDisconnect; de lo contrario, podría producirse un error catastrófico en el hardware que deshabilitaría otros clientes de XAPU activos. No se recomienda llamar a XapuConnect y XApuDisconnect con frecuencia para iniciar y detener secuencias, ya que esas llamadas consumen mucho tiempo y también podrían provocar pérdidas de recursos debido a la fragmentación de la memoria. En su lugar, se debe llamar a XapuConnect una vez al inicializar la sesión de transmisión y, a continuación, usar XApuCommandType::Activate y XApuCommandType::Deactivate para iniciar y detener secuencias durante la transmisión. Al final de la sesión de transmisión, se debe llamar a XApuDisconnect. Esto se aplica a todos los clientes de XAPU.Requisitos
Encabezado: xapu.h Biblioteca: xapu.lib Plataformas compatibles: XBOX Series X|SDocumentación conceptual
Consulte también
XApuConnectXAPU