IXAudio2::Release 方法 (xaudio2.h)

释放对 XAudio2 对象的引用。

语法

ULONG Release();

返回值

始终返回 0。

注解

在给定的 XAudio2 对象上调用最终 Release 时,将销毁与其关联的所有语音对象。 指向客户端仍保留的这些对象的指针会立即失效。 对它们进行的任何调用都会导致未定义的行为。 音频处理引擎也会停止。 这样,在返回 Release 后,客户端可以安全地释放图形 (引用的任何数据,例如音频源缓冲区或) 回调处理对象。

Release 是同步调用。 虽然故障不应 (发生,因为它只会短暂地) 处理锁,但游戏可以通过在 XAudio2 回调中调用此方法来避免潜在的线程等待时间。

从回调 (IXAudio2EngineCallbackIXAudio2VoiceCallback) 调用 Release 无效。

平台要求

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

要求

   
目标平台 Windows
标头 xaudio2.h

另请参阅

IXAudio2