Microsoft DirectX 8.0 (C++)

IDirectMusicPerformance8::Stop

セグメントまたはセグメント状態の再生を停止する。

現在は、このメソッドに代えて IDirectMusicPerformance8::StopEx が使用されている。これを使うと、セグメント、セグメント状態、またはオーディオパスを停止できる。

HRESULT Stop(
  IDirectMusicSegment* pSegment, 
  IDirectMusicSegmentState* pSegmentState, 
  MUSIC_TIME mtTime, 
  DWORD dwFlags
);

パラメータ

pSegment
演奏を停止するセグメント。このセグメントに基づくすべてのセグメント状態は、mtTime の時点で停止される。「注意」を参照すること。
pSegmentState
演奏を停止するセグメント状態。「注意」を参照すること。
mtTime
セグメント、セグメント状態、またはその両方を停止するタイム。このタイムが過去のタイムである場合や、値として 0 を指定した場合は、指定セグメントとセグメント状態の演奏が即座に停止される。
dwFlags
演奏の停止タイムを指定するフラグ。境界は現在のプライマリ セグメントに関連する。値のリストについては、「IDirectMusicPerformance8::StopEx」を参照すること。

戻り値

成功した場合は S_OK を返す。

失敗した場合は E_POINTER を返す。

注意

pSegment pSegmentState の両方が NULL である場合、すべての音楽は停止し、現在キューに置かれているすべてのセグメントが解放される。pSegment pSegmentState のどちらかが NULL ではない場合、指定されたセグメント状態がパフォーマンスから削除される。両方共 NULL ではなく、なおかつ DMUS_SEGF_DEFAULT が使われている場合、pSegment から得られたデフォルトの分解能を使う。

すべてのパラメータに NULL または 0 を設定すると、すべての演奏が即座に停止し、コントローラ リセット メッセージおよびノートオフ メッセージが、マップされたすべてのパフォーマンス チャンネルに送信される。

動作環境

  ヘッダー : dmusici.h で宣言。

参照

IDirectMusicPerformance8::PlaySegmentIDirectMusicPerformance8::PlaySegmentExIDirectMusicPerformance8::StopExDMUS_SEGF_FLAGS