Compartir a través de


Método IXAudio2::Release (xaudio2.h)

Libera una referencia al objeto XAudio2.

Sintaxis

ULONG Release();

Valor devuelto

Siempre devuelve 0.

Comentarios

Cuando se llama a la versión final en un objeto XAudio2 determinado, se destruyen todos los objetos de voz asociados a él. Los punteros a estos objetos que el cliente sigue manteniendo no son válidos inmediatamente. Las llamadas realizadas a ellas provocan un comportamiento indefinido. El motor de procesamiento de audio también se detiene. Esto es así que, después de que se devuelva Release , el cliente puede liberar de forma segura los datos a los que hace referencia el grafo (por ejemplo, búferes de origen de audio o objetos de control de devolución de llamada).

Release es una llamada sincrónica. Aunque no debe producirse glitching (ya que solo toma brevemente el bloqueo de procesamiento), un título puede evitar posibles tiempos de espera de subprocesos llamando a este método en una devolución de llamada XAudio2.

No es válido llamar a Release desde una devolución de llamada (es decir, IXAudio2EngineCallback o IXAudio2VoiceCallback).

Requisitos de la plataforma

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); SDK de DirectX (XAudio 2.7)

Requisitos

   
Plataforma de destino Windows
Encabezado xaudio2.h

Consulte también

IXAudio2