Microsoft DirectX 8.0 (C++)

IDirectMusicSegment8::SetStartPoint

セグメントの演奏を開始するポイントを設定する。

HRESULT SetStartPoint(
  MUSIC_TIME mtStart
);

パラメータ

mtStart
セグメントの演奏開始ポイント。0 以上で、セグメントの長さより小さくなければならない。

戻り値

成功した場合は S_OK を返す。

失敗した場合は DMUS_E_OUT_OF_RANGE を返す。

注意

開始ポイントは、聞くことのできるセグメントの最初のポイントである。ただし、セグメントの開始ポイントが経過時間に合わせてある場合、実際に聞こえる最初のポイントは、これより遅くなる。詳細については、「セグメントのタイミング」を参照すること。

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

セグメントがまだ長さを持っていない場合、このメソッドの前に IDirectMusicSegment8::SetLength を呼び出さなければならない。

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

キャッシングされたセグメントの開始ポイントは、セグメントが解放され、再ロードされた場合でも継続される。セグメントが後でキャッシュから再ロードされないようにするには、セグメントを解放する前に、IDirectMusicLoader8::ReleaseObject を呼び出す。

動作環境

  ヘッダー : dmusici.h で宣言。

参照

IDirectMusicSegment8::GetStartPointIDirectMusicSegmentState8::GetStartPointIDirectMusicSegment8::SetLengthIDirectMusicSegment8::SetLoopPointsセグメントのタイミング