Microsoft DirectX 8.0 (Visual Basic)

DirectSound8.DuplicateSoundBuffer

オリジナル バッファのメモリを複製または共有する、新しいセカンダリ バッファを作成する。

object.DuplicateSoundBuffer( _
  original As DirectSoundSecondaryBuffer8 _
) As DirectSoundSecondaryBuffer8

指定項目

object
DirectSound8 オブジェクトを指定する。
original
複製する DirectSoundSecondaryBuffer8 オブジェクト。

戻り値

DirectSoundSecondaryBuffer8 オブジェクトを返す。

エラー コード

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

DSERR_ALLOCATED
DSERR_INVALIDCALL
DSERR_OUTOFMEMORY
DSERR_UNINITIALIZED

注意

このメソッドは、DSBCAPS_CTRLFX フラグを使って作成したバッファには無効である。

複製直後のバッファは、オリジナル バッファと同じパラメータを持つ。ただし、アプリケーションは各バッファのパラメータを個別に変更でき、各バッファは互いに影響を及ぼすことなく再生と停止を行える。

後に残った参照側オブジェクトが解放されると、バッファ メモリは解放される。

複製バッファが同じメモリを共有する場合もあるが、常にそうであるとは限らない。バッファに格納されたデータに対する変更は、複製に必ずしも反映されない。

参照

DirectSound8.CreateSoundBufferDirectSound8.CreateSoundBufferFromFileDirectSound8.CreateSoundBufferFromResource