Microsoft DirectX 8.0 (C++)

IDirectSoundCaptureBuffer8::Unlock

バッファをアンロックする。

HRESULT Unlock(
  LPVOID pvAudioPtr1, 
  DWORD dwAudioBytes1, 
  LPVOID pvAudioPtr2, 
  DWORD dwAudioBytes2 
);

パラメータ

pvAudioPtr1
IDirectSoundCaptureBuffer8::Lock メソッドの ppvAudioPtr1 パラメータで取得した値のアドレス。
dwAudioBytes1
pvAudioPtr1 パラメータから読み込むバイト数。「注意」を参照すること。
pvAudioPtr2
IDirectSoundCaptureBuffer8::Lock メソッドの ppvAudioPtr2 パラメータで取得した値のアドレス。
dwAudioBytes2
pvAudioPtr2 パラメータから読み込むバイト数。「注意」を参照すること。

戻り値

成功した場合は DS_OK を返す。

失敗した場合は、次のいずれかの値を返す。

DSERR_INVALIDPARAM
DSERR_INVALIDCALL

注意

アプリケーションは、IDirectSoundBuffer8::Lock メソッドで返されるポインタ pvAudioPtr1 および pvAudioPtr2 の両方を渡して、IDirectSoundBuffer8::LockIDirectSoundBuffer8::Unlock の対を正しく指定しなければならない。たとえ 2 番目のポインタに 0 バイトが書き込まれた場合でも、2 番目のポインタは必要である。

dwAudioBytes1 および dwAudioBytes2 の値は、バッファの各部分から実際に読み込むバイト数を指定しなければならない。ロックのサイズより小さくなる場合もある。DirectSound はこれらの値を使用して、デバイスから転送するデータ量を決定する。

サウンド キャプチャ バッファのロック状態を長時間維持しないよう注意すること。

動作環境

  ヘッダー : dsound.h で宣言。