IXAudio2::Release メソッド (xaudio2.h)

  • [アーティクル]

XAudio2 オブジェクトへの参照を解放します。

構文

ULONG Release();

戻り値

常に 0 を返します。

Remarks

特定の XAudio2 オブジェクトで最後の Release が呼び出されると、それに関連付けられているすべての音声オブジェクトが破棄されます。 クライアントによって保持されているこれらのオブジェクトへのポインターは、すぐに無効になります。 それらに対して行われた呼び出しは、未定義の動作を引き起こします。 オーディオ処理エンジンも停止します。 これは、 Release が返された後、クライアントがグラフによって参照されるすべてのデータ (オーディオ ソース バッファーやコールバック処理オブジェクトなど) を安全に解放できるようにするためです。

リリース は同期呼び出しです。 グリッチは発生しませんが (処理ロックを一時的にしか受け取らないので)、タイトルは XAudio2 コールバックでこのメソッドを呼び出すことで、スレッドの待機時間の可能性を回避できます。

コールバック (IXAudio2EngineCallback または IXAudio2VoiceCallback) 内から Release を呼び出すと無効です。

プラットフォームの要件

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

要件

   
対象プラットフォーム Windows
ヘッダー xaudio2.h

関連項目

IXAudio2