Microsoft DirectX 8.0 (Visual Basic)

DirectSoundSecondaryBuffer8.ReadBuffer

サウンド バッファのセグメントを読み込み、アプリケーション バッファにそのデータを格納する。

セカンダリ バッファは DirectSoundSecondaryBuffer8.Play メソッドに応じて、データを自動的にプライマリ バッファに送信するため、ほとんどのアプリケーションはこのメソッドを使用しない。

object.ReadBuffer( _
  start As Long, _
  size As Long, _
  buffer As Any, _
  flags As CONST_DSBLOCKFLAGS)

指定項目

object
DirectSoundSecondaryBuffer8 オブジェクトを指定する。
start
バッファの先頭から読み込み開始位置までのオフセット (バイト単位)。flags パラメータに DSBLOCK_FROMWRITECURSOR が指定された場合、このパラメータは無視される。
size
読み込むバッファ部分のサイズ (バイト単位)。サウンド バッファは概念的には循環バッファであるため、この値はバッファの start から最後までの間のバイト数よりも大きい値になる。flags パラメータに DSBLOCK_ENTIREBUFFER が指定された場合、このパラメータは無視される。
buffer
データを受け取る変数。通常、これはバイトの配列であり、配列の先頭要素を渡す。
flags
CONST_DSBLOCKFLAGS 列挙の定数の 1 つ。

エラー コード

失敗した場合はエラーが発生し、Err.Number に次のいずれかのエラー コードが設定される。

DSERR_BUFFERLOST
DSERR_INVALIDCALL
DSERR_INVALIDPARAM
DSERR_PRIOLEVELNEEDED