Microsoft DirectX 8.0 (Visual Basic)

DirectSound8.CreateSoundBufferFromFile

サンプリング オーディオをプライマリ バッファにミキシングするためのセカンダリ バッファを作成し、ファイルからバッファにデータをロードする。

object.CreateSoundBufferFromFile( _
  filename As String, _
  bufferDesc As DSBUFFERDESC _
) As DirectSoundSecondaryBuffer8

指定項目

object
DirectSound8 オブジェクトを指定する。
filename
作成したバッファにロードするウェーブ ファイル名。
bufferDesc
作成するサウンド バッファの記述を指定する DSBUFFERDESC 型。メソッドは、データそのものから形式およびサイズを判断するため、fxFormat および lBufferBytes メンバは無視される。

戻り値

DirectSoundSecondaryBuffer8 オブジェクトを返す。

エラー コード

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

DSERR_ALLOCATED
DSERR_BADFORMAT
DSERR_BUFFERTOOSMALL
DSERR_CONTROLUNAVAIL
DSERR_INVALIDCALL
DSERR_OUTOFMEMORY
DSERR_UNINITIALIZED
DSERR_UNSUPPORTED

注意

ハードウェア アクセラレーションを利用できないシステムで DSBCAPS_LOCHARDWARE フラグを使ってバッファを作成しようとすると、メソッドは失敗し、Windows 95 および Windows 98 では DSERR_CONTROLUNAVAIL を返す。Windows 2000 では DSERR_INVALIDCALL を返す。

参照

DirectSound8.CreateSoundBufferDirectSound8.CreateSoundBufferFromResourceDirectSound8.DuplicateSoundBuffer