Share via

IDirectSoundCaptureBuffer8::Unlock

  • [アーティクル]

Unlock メソッドは、バッファーをロック解除します。

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

パラメータ

  • pvAudioPtr1
    Lock メソッドの ppvAudioPtr1 パラメーターで取得した値のアドレスです。
  • dwAudioBytes1
    pvAudioPtr1 パラメーターから読み込んだバイト数です。「解説」を参照してください。
  • pvAudioPtr2
    IDirectSoundCaptureBuffer8::Lock メソッドの ppvAudioPtr2 パラメーターで取得した値のアドレスです。
  • dwAudioBytes2
    pvAudioPtr2 パラメーターから読み込んだバイト数です。「解説」を参照してください。

戻り値

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

リターン コード
DSERR_INVALIDPARAM
DSERR_INVALIDCALL

解説　

アプリケーションは、IDirectSoundCaptureBuffer8::Lock メソッドで返されるポインター pvAudioPtr1 と pvAudioPtr2 の両方を渡して、IDirectSoundCaptureBuffer8::Lock と IDirectSoundCaptureBuffer8::Unlock の対を正しく指定する必要があります。2 番目のポインターに書き込んだデータが 0 バイトであっても、2 番目のポインターは必要です。

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

キャプチャー バッファーのロック状態を長時間維持しないでください。

要件

ヘッダー: DSound.h 宣言

ライブラリ: Dsound3d.dll 内容

関連項目

IDirectSoundCaptureBuffer8