Microsoft DirectX 8.0 (Visual Basic) |
セグメント内のループ部分の開始ポイントと終了ポイントを設定する。ループの反復回数は DirectMusicSegment8.SetRepeats メソッドによって設定される。
object.SetLoopPoints(mtStart As Long, mtEnd As Long)
失敗した場合はエラーが発生し、Err.Number に DMUS_E_OUT_OF_RANGE が設定される。
セグメントの演奏時には、開始タイムから mtEnd まで演奏し、mtStart にループする。次に、ループ部分を DirectMusicSegment8.SetRepeats によって設定される回数だけ反復し、最後まで演奏する。
デフォルト値は、最初から最後までセグメント全体をループするように設定されている。
mtStart の値がセグメントの長さ以上の場合、または mtEnd の値がセグメントの長さを超える場合、メソッドは失敗する。mtEnd が 0 の場合、mtStart も 0 でなければならない。
このメソッドは、このセグメントから作成された、現在演奏中のセグメント状態に影響を及ぼすことはない。
再利用されるセグメントは、内部キャッシュからロードされる可能性もある。その場合、そのセグメントのループ ポイントは、最後に設定された値と同じ値を持つ。再び演奏する可能性のあるセグメントを解放する前には、ループ ポイントを 0 にリセットするとよい。
DirectMusicSegment8.GetLoopPointStart、DirectMusicSegment8.GetLoopPointEnd、DirectMusicSegment8.SetRepeats