Platform SDK: DirectX

IDirectMusicPerformance::Invalidate

IDirectMusicPerformance::Invalidate メソッドは、指定されたタイムから前方に向かってキュー内のすべてのメッセージをフラッシュ (解放) し、指定されたタイムから前方に向かってすべてのセグメントがデータを再送するようすべてのトラックに通知する。

HRESULT Invalidate(
  MUSIC_TIME mtTime, 
  DWORD dwFlags
);

パラメータ

mtTime
無効にするタイム。dwFlags によって調整を加えられる。この値を 0 に設定すると、即座に無効にする。
dwFlags
mtTime を調整して小節、拍、またはグリッドに揃えるフラグ。この値は、0 または次に示す DMUS_SEGF_FLAGS 列挙型メンバのいずれかである。

DMUS_SEGF_MEASURE
DMUS_SEGF_BEAT
DMUS_SEGF_GRID

戻り値

成功すれば S_OK を返す。

失敗すれば DMUS_E_NO_MASTER_CLOCK を返す。

注意

mtTime がかなり前のタイムで、そのタイムで無効化が行えない場合は、利用可能な範囲で最も早いタイムを使う。

動作環境

  Windows NT/2000 : Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dmusici.h で宣言。

参照

準備時間セグメントのタイミング