Microsoft DirectX 8.0 (Visual Basic)

DirectMusicSegment8.SetLoopPoints

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

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

指定項目

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

エラー コード

失敗した場合はエラーが発生し、Err.NumberDMUS_E_OUT_OF_RANGE が設定される。

注意

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

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

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

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

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

参照

DirectMusicSegment8.GetLoopPointStartDirectMusicSegment8.GetLoopPointEndDirectMusicSegment8.SetRepeats