XApuDisconnect
Se déconnecte du serveur matériel et libère toutes les ressources allouées lors de XApuConnect.Syntaxe
Paramètres
handle _In_Type : XApuHandle Handle retourné par l’appel à XApuConnect.
Valeur renvoyée
Type : HRESULT RetourneS_OK en cas de réussite ; sinon, retourne un code d’erreur.
Remarques
En plus de se déconnecter du serveur matériel, cet appel libère également XApuConnectOutputParameters::baseData et ferme le handle XApuConnectOutputParameters::resultReadyEvent. Si XApuDisconnect est appelé avant que toutes les commandes en file d’attente soient traitées, il libère toutes les ressources et retourne le code d’erreur XAPU_E_PENDING_RESULTS. L’appelant doit attendre le résultat de la dernière commande mise en file d’attente avant d’appeler XApuDisconnect ; sinon, une défaillance catastrophique peut se produire dans le matériel, ce qui désactiverait les autres clients XAPU actifs. Il n’est pas recommandé d’appeler fréquemment XapuConnect et XApuDisconnect pour démarrer et arrêter des flux, car ces appels sont coûteux en temps et peuvent également entraîner des pertes de ressources dues à la fragmentation de la mémoire. XapuConnect doit plutôt être appelé une seule fois lors de l’initialisation de la session de streaming, puis XApuCommandType::Activate et XApuCommandType::Deactivate doivent être utilisés pour démarrer et arrêter des flux pendant le streaming. À la fin de la session de streaming, XApuDisconnect doit être appelé. Cela s’applique à tous les clients XAPU.Configuration requise
En-tête : xapu.h Bibliothèque : xapu.lib Plateformes prises en charge : XBOX Series X|SDocumentation conceptuelle
Voir aussi
XApuConnectXAPU