IDirectSoundBuffer8::Unlock
Unlock メソッドは、ロックされたサウンド バッファーを解放します。
HRESULT
Unlock(
LPVOID pvAudioPtr1,
DWORD dwAudioBytes1,
LPVOID pvAudioPtr2,
DWORD dwAudioBytes2
);
パラメータ
- pvAudioPtr1
Lock メソッドの ppvAudioPtr1 パラメーターで取得した値のアドレスです。 - dwAudioBytes1
バッファーの pvAudioPtr1 で表される位置に書き込まれたバイト数です。「解説」を参照してください。 - pvAudioPtr2
IDirectSoundBuffer8::Lock メソッドの ppvAudioPtr2 パラメーターで取得した値のアドレスです。 - dwAudioBytes2
バッファーの pvAudioPtr2 で表される位置に書き込まれたバイト数です。「解説」を参照してください。
戻り値
成功した場合は、DS_OK を返します。失敗した場合は、次のいずれかのエラー値を返します。
リターン コード |
DSERR_INVALIDCALL |
DSERR_INVALIDPARAM |
DSERR_PRIOLEVELNEEDED |
解説
アプリケーションは、IDirectSoundBuffer8::Lock メソッドで返されるポインター pvAudioPtr1 および pvAudioPtr2 の両方を渡して、IDirectSoundBuffer8::Lock と IDirectSoundBuffer8::Unlock の対を正しく指定する必要があります。2 番目のポインターに何も書き込まれていない場合でも、2 番目のポインターは必要です。
dwAudioBytes1 および dwAudioBytes2 の値では、バッファーの各部分に実際に書き込まれたバイト数を指定する必要があります。この値は、ロックのサイズより小さくなる場合があります。DirectSound はこれらの値を使用して、デバイスにコミットするデータの量を決定します。
要件
ヘッダー: DSound.h 宣言
ライブラリ: Dsound3d.dll 内容