Platform SDK: DirectX

DirectMusicSegment.SetLoopPoints

DirectMusicSegment.SetLoopPoints メソッドは、セグメント内のループ部分の開始ポイントと終了ポイントを設定する。反復回数は DirectMusicSegment.SetRepeats メソッドによって設定される。

object.SetLoopPoints(mtStart As Long, mtEnd As Long)

パラメータ

object
DirectMusicSegment オブジェクトを表すオブジェクト式。
mtStart
ループの開始ポイント。ミュージック タイムで指定する。
mtEnd
ループの終了ポイント。ミュージック タイムで指定する。値 0 は、セグメント全体をループさせることを意味する。

エラー コード

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

注意

セグメントの演奏時には、開始タイムから mtEnd まで演奏し、mtStart にループする。次に、ループ部分を DirectMusicSegment.SetRepeats によって設定される回数だけ反復し、最後まで演奏する。

デフォルト値は、最初から最後までセグメント全体をループさせるように設定されている。

mtStart の値がセグメントの長さ以上の場合、または mtEnd の値がセグメントの長さを超える場合、メソッドは失敗する。mtEnd が 0 の場合、mtStart も 0 でなければならない。

このメソッドは、このセグメントから作成された、現在演奏中のセグメント状態に影響を及ぼすことはない。

再利用されるセグメントは、内部キャッシュからロードされる可能性もある。その場合、そのセグメントのループ ポイントは、最後に設定された値と同じ値を持つ。オブジェクトを解放またはリセットする前には、ループ ポイントを 0 にリセットするとよい。

参照

DirectMusicSegment.GetLoopPointStartDirectMusicSegment.GetLoopPointEndDirectMusicSegment.SetRepeats