IXAudio2Voice::DestroyVoice
ボイスを破棄します。必要に応じて、ボイスを停止し、XAudio2 グラフから削除します。
void
DestroyVoice(
);
パラメータ
なし。
戻り値
なし。
解説
現在このボイスに他のボイスがオーディオを送信している場合、このメソッドは失敗します。
DestroyVoice は、オーディオ処理スレッドがアイドルになるまで待機するので、しばらく時間がかかることがあります (通常は数ミリ秒以内です)。これは、ボイスがコールバックやオーディオ データの読み取りを行っていない状態を保証するために必要です。これによって、呼び出しを行って応答が返されるとすぐ、アプリケーションはこれらのリソースを安全に解放することができます。
コールバック内からの DestroyVoice の呼び出しは無効です。コールバック内から DestroyVoice を呼び出すと、XAUDIO2_E_INVALID_CALL が返されます。
要件
ヘッダー: Xaudio2.h 宣言