Platform SDK: DirectX

DirectMusicPerformance.Invalidate

DirectMusicPerformance.Invalidate メソッドは、指定されたタイムより後のタイム スタンプを持つキュー内のすべてのメッセージをフラッシュ (解放) し、指定されたタイムから前方に向かって、すべてのセグメントのすべてのトラックにデータを再送させる。

object.Invalidate(mtTime As Long, flags As Long)

パラメータ

object
DirectMusicPerformance オブジェクトを表すオブジェクト式。
mtTime
無効にするタイム。flags によって調整される。この値を 0 に設定すると、即座に無効になる。
flags
mtTime を調整して小節、拍、またはグリッドに揃える。この値は、0 または次に示す CONST_DMUS_SEGF_FLAGS のいずれかのメンバでもよい。

DMUS_SEGF_MEASURE
DMUS_SEGF_BEAT
DMUS_SEGF_GRID

エラー コード

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

注意

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

参照

DirectMusicPerformance.GetQueueTime