Microsoft DirectX 8.0 (C++) |
セグメントの演奏を開始するポイントを設定する。
HRESULT SetStartPoint( MUSIC_TIME mtStart );
成功した場合は S_OK を返す。
失敗した場合は DMUS_E_OUT_OF_RANGE を返す。
開始ポイントは、聞くことのできるセグメントの最初のポイントである。ただし、セグメントの開始ポイントが経過時間に合わせてある場合、実際に聞こえる最初のポイントは、これより遅くなる。詳細については、「セグメントのタイミング」を参照すること。
デフォルトの開始ポイントは 0 であり、セグメントの先頭から開始することを意味する。
セグメントがまだ長さを持っていない場合、このメソッドの前に IDirectMusicSegment8::SetLength を呼び出さなければならない。
このメソッドは、このセグメントから作成された、現在演奏中のセグメント状態に影響を及ぼすことはない。
キャッシングされたセグメントの開始ポイントは、セグメントが解放され、再ロードされた場合でも継続される。セグメントが後でキャッシュから再ロードされないようにするには、セグメントを解放する前に、IDirectMusicLoader8::ReleaseObject を呼び出す。
ヘッダー : dmusici.h で宣言。
IDirectMusicSegment8::GetStartPoint、IDirectMusicSegmentState8::GetStartPoint、IDirectMusicSegment8::SetLength、IDirectMusicSegment8::SetLoopPoints、セグメントのタイミング