Platform SDK: DirectX |
IDirectSoundBuffer::Unlock メソッドは、サウンド バッファをアンロックする。
HRESULT Unlock( LPVOID lpvAudioPtr1, DWORD dwAudioBytes1, LPVOID lpvAudioPtr2, DWORD dwAudioBytes2 );
成功すれば DS_OK、失敗すれば次のエラー値のいずれかを返す。
DSERR_INVALIDCALL |
DSERR_INVALIDPARAM |
DSERR_PRIOLEVELNEEDED |
アプリケーションは、IDirectSoundBuffer::Lock と IDirectSoundBuffer::Unlock を正しく組み合わせて、IDirectSoundBuffer::Lock メソッドが返したポインタ lpvAudioPtr1 と lpvAudioPtr2 の両方を IDirectSoundBuffer::Unlock に渡さなければならない。たとえ 2 番目のポインタに 0 バイトが書き込まれた場合でも、2 番目のポインタは必要である。
アプリケーションは 2 つのポインタに実際に書き込まれたバイト数を、dwAudioBytes1 と dwAudioBytes2 の各パラメータに渡さなければならない。
サウンド バッファのロック状態を長時間維持しないよう注意すること。
Windows NT/2000 : Service Pack 3 を適用した Windows NT バージョン 4.0 以降が必要。
Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
ヘッダー : dsound.h で宣言。
インポート ライブラリ : dsound.lib を使用。
IDirectSoundBuffer、IDirectSoundBuffer::GetCurrentPosition、IDirectSoundBuffer::Lock