Platform SDK: DirectX

DirectMusicSegment.Clone

DirectMusicSegment.Clone メソッドは、セグメントのすべてまたはパートのコピーを作成する。

object.Clone(mtStart As Long, _
    mtEnd As Long) As DirectMusicSegment

パラメータ

object
DirectMusicSegment オブジェクトを表すオブジェクト式。
mtStart
複製開始パート。ミュージック タイムで指定する。0 未満の場合や、セグメントの長さを超える場合は、0 が使用される。
mtEnd
複製終了パート。ミュージック タイムで指定する。この値がセグメントの最後を超える場合は、セグメントの最後までコピーされる。0 または mtStart 未満の場合も、最後までコピーされる。

戻り値

成功すれば DirectMusicSegment オブジェクトを返す。

エラー コード

失敗すればエラーが発生し、Err.NumberDMUS_E_OUTOFMEMORY が設定される。

注意

DirectMusicSegment.SetStartPointDirectMusicSegment.SetLoopPoints の各メソッドによって設定された開始ポイントとループ ポイントは、クローンの内部でデフォルト値 (開始ポイントは 0、ループ ポイントはセグメントの終わりを意味する 0) に設定される。反復回数も 0 にリセットされる。

スタイルベースのセグメントは、mtStart が 0 より大きい場合、小節境界上になければならない。