Microsoft DirectX 8.0 (Visual Basic) |
オリジナル バッファのメモリを複製または共有する、新しいセカンダリ バッファを作成する。
object.DuplicateSoundBuffer( _ original As DirectSoundSecondaryBuffer8 _ ) As DirectSoundSecondaryBuffer8
DirectSoundSecondaryBuffer8 オブジェクトを返す。
失敗した場合はエラーが発生し、Err.Number に次のいずれかのエラー値が設定される。
DSERR_ALLOCATED |
DSERR_INVALIDCALL |
DSERR_OUTOFMEMORY |
DSERR_UNINITIALIZED |
このメソッドは、DSBCAPS_CTRLFX フラグを使って作成したバッファには無効である。
複製直後のバッファは、オリジナル バッファと同じパラメータを持つ。ただし、アプリケーションは各バッファのパラメータを個別に変更でき、各バッファは互いに影響を及ぼすことなく再生と停止を行える。
後に残った参照側オブジェクトが解放されると、バッファ メモリは解放される。
複製バッファが同じメモリを共有する場合もあるが、常にそうであるとは限らない。バッファに格納されたデータに対する変更は、複製に必ずしも反映されない。
DirectSound8.CreateSoundBuffer、DirectSound8.CreateSoundBufferFromFile、DirectSound8.CreateSoundBufferFromResource