Platform SDK: DirectX |
DirectMusicSegment.SetStartPoint メソッドは、セグメントが DirectMusicPerformance.PlaySegment メソッドの呼び出しに応答して演奏を開始するポイントを設定する。
object.SetStartPoint(mtStart As Long)
失敗すればエラーが発生し、Err.Number に DMUS_E_OUT_OF_RANGE が設定される。
デフォルトの開始ポイントは 0 であり、セグメントの先頭から開始することを意味する。
mtStart の値がセグメントの長さ以上の場合、この呼び出しは失敗する。
このメソッドは、このセグメントから作成された、現在演奏中のセグメント状態に影響を及ぼすことはない。
再利用されるセグメントは、内部キャッシュからロードされる可能性もある。その場合、そのセグメントの開始ポイントは、最後に設定された値と同じ値を持つ。オブジェクトを解放またはリセットする前には、開始ポイントを 0 に設定するとよい。
DirectMusicSegment.GetStartPoint、DirectMusicSegmentState.GetStartPoint、DirectMusicSegment.SetLoopPoints