Microsoft DirectX 8.0 (Visual Basic)

DirectMusicPerformance8.Invalidate

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

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

指定項目

object
DirectMusicPerformance8 オブジェクトを指定する。
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 がかなり前のタイムで、そのタイムで無効化が行えない場合は、利用可能な範囲で最も早いタイムを使用する。

参照

DirectMusicPerformance8.GetQueueTime