次の方法で共有


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 内容

関連項目

IDirectSoundBuffer8