Platform SDK: DirectX

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.PlaySegmentCONST_DMUS_SEGF_FLAGS