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 de retour
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 XapuConnect et XApuDisconnect fréquemment pour démarrer et arrêter des flux, car ces appels prennent du temps et peuvent également entraîner des pertes de ressources en raison de la fragmentation de la mémoire. Appelez plutôt XapuConnect une seule fois lors de l’initialisation de la session de diffusion en continu, puis utilisez XApuCommandType::Activate et XApuCommandType::Deactivate pour démarrer et arrêter les flux pendant la diffusion. À la fin de la session de diffusion en continu, appelez XApuDisconnect. 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