Platform SDK: DirectX

DirectMusicSegment.SetStartPoint

DirectMusicSegment.SetStartPoint メソッドは、セグメントが DirectMusicPerformance.PlaySegment メソッドの呼び出しに応答して演奏を開始するポイントを設定する。

object.SetStartPoint(mtStart As Long)

パラメータ

object
DirectMusicSegment オブジェクトを表すオブジェクト式。
mtStart
セグメントの演奏開始ポイント。ミュージック タイムで指定する。この値が 0 未満またはセグメントの長さより大きい場合、開始ポイントは 0 に設定される。

エラー コード

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

注意

デフォルトの開始ポイントは 0 であり、セグメントの先頭から開始することを意味する。

mtStart の値がセグメントの長さ以上の場合、この呼び出しは失敗する。

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

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

参照

DirectMusicSegment.GetStartPointDirectMusicSegmentState.GetStartPointDirectMusicSegment.SetLoopPoints