DirectMusicPerformance.Stop
DirectMusicPerformance.Stop メソッドは、1 つまたは複数のセグメントの再生を停止する。
object.Stop(segment As DirectMusicSegment, _
segmentState As DirectMusicSegmentState, _
mtTime As Long, _
lFlags As Long)
パラメータ
- object
- DirectMusicPerformance オブジェクトを表すオブジェクト式。
- segment
- 演奏を停止する DirectMusicSegment オブジェクト。このセグメントに基づくすべてのセグメント状態は、mtTime の時点で停止される。「注意」を参照すること。
- segmentState
- 演奏を停止するセグメントのインスタンスを表す DirectMusicSegmentState オブジェクト。「注意」を参照すること。
- mtTime
- セグメント、セグメント状態、またはその両方を停止するミュージックタイム。このタイムが過去のタイムである場合や、値として 0 を指定した場合は、要求したセグメントとセグメント状態の演奏が即座に停止される。
- lFlags
- 演奏の停止タイムを指定するフラグ。境界は現在のプライマリ セグメントに関連する。次の値のいずれかを使わなければならない。
- 0
- 即座に停止する。
- DMUS_SEGF_GRID
- 次のグリッド境界または mtTime の後に停止する。
- DMUS_SEGF_MEASURE
- 次の小節境界または mtTime の後に停止する。
- DMUS_SEGF_BEAT
- 次の拍境界または mtTime の後に停止する。
エラー コード
失敗すればエラーが発生し、Err.Number が設定される。
注意
segment と segmentState の両方が NULL である場合、すべての音楽は停止し、現在キューに置かれているすべてのセグメントが解放される。segment と segmentState のどちらかが NULL ではない場合、指定されたセグメント状態がパフォーマンスから削除される。
すべてのパラメータに NULL または 0 を設定すると、すべての演奏が即座に停止し、コントローラ リセット メッセージおよびノートオフ メッセージが、マップされたすべてのパフォーマンス チャンネルに送信される。
参照
DirectMusicPerformance.PlaySegment、CONST_DMUS_SEGF_FLAGS