IXAudio2::Release, méthode (xaudio2.h)

Libère une référence à l’objet XAudio2.

Syntaxe

ULONG Release();

Valeur de retour

Retourne toujours 0.

Remarques

Lorsque la version finale est appelée sur un objet XAudio2 donné, tous les objets vocaux qui lui sont associés sont détruits. Tous les pointeurs vers ces objets qui sont toujours détenus par le client deviennent immédiatement non valides. Tous les appels qui leur sont passés entraînent un comportement non défini. Le moteur de traitement audio est également arrêté. Cela permet au client de libérer en toute sécurité toutes les données référencées par le graphique (par exemple, les mémoires tampons de source audio ou les objets de gestion des rappels).

Release est un appel synchrone. Bien que les glitchings ne doivent pas se produire (car il ne prend que brièvement le verrou de traitement), un titre peut éviter les temps d’attente de thread potentiels en appelant cette méthode dans un rappel XAudio2.

Il n’est pas valide d’appeler Release à partir d’un rappel (autrement dit, IXAudio2EngineCallback ou IXAudio2VoiceCallback).

Configuration requise pour la plateforme

Spécifications

Voir aussi

IXAudio2