Поделиться через


Метод IXAudio2::Release (xaudio2.h)

Освобождает ссылку на объект XAudio2.

Синтаксис

ULONG Release();

Возвращаемое значение

Всегда возвращает 0.

Комментарии

При вызове окончательного выпуска для заданного объекта XAudio2 все связанные с ним голосовые объекты уничтожаются. Все указатели на эти объекты, которые по-прежнему хранятся у клиента, немедленно становятся недействительными. Все вызовы, которые выполняются к ним, вызывают неопределенное поведение. Подсистема обработки звука также остановлена. Это позволяет клиенту безопасно освободить все данные, на которые ссылается граф (например, буферы источника звука или объекты обработки обратного вызова).

Release — это синхронный вызов. Хотя сбой не должен происходить (так как он занимает только кратковременную блокировку обработки), заголовок может избежать потенциального времени ожидания потока путем вызова этого метода в обратном вызове XAudio2.

Недопустимо вызывать Release из обратного вызова (то есть IXAudio2EngineCallback или IXAudio2VoiceCallback).

Требования к платформе

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); Пакет SDK Для DirectX (XAudio 2.7)

Требования

   
Целевая платформа Windows
Header xaudio2.h

См. также раздел

IXAudio2