Microsoft DirectX 8.0 (C++) |
セグメントまたはセグメント状態の再生を停止する。
現在は、このメソッドに代えて IDirectMusicPerformance8::StopEx が使用されている。これを使うと、セグメント、セグメント状態、またはオーディオパスを停止できる。
HRESULT Stop( IDirectMusicSegment* pSegment, IDirectMusicSegmentState* pSegmentState, MUSIC_TIME mtTime, DWORD dwFlags );
成功した場合は S_OK を返す。
失敗した場合は E_POINTER を返す。
pSegment と pSegmentState の両方が NULL である場合、すべての音楽は停止し、現在キューに置かれているすべてのセグメントが解放される。pSegment と pSegmentState のどちらかが NULL ではない場合、指定されたセグメント状態がパフォーマンスから削除される。両方共 NULL ではなく、なおかつ DMUS_SEGF_DEFAULT が使われている場合、pSegment から得られたデフォルトの分解能を使う。
すべてのパラメータに NULL または 0 を設定すると、すべての演奏が即座に停止し、コントローラ リセット メッセージおよびノートオフ メッセージが、マップされたすべてのパフォーマンス チャンネルに送信される。
ヘッダー : dmusici.h で宣言。
IDirectMusicPerformance8::PlaySegment、IDirectMusicPerformance8::PlaySegmentEx、IDirectMusicPerformance8::StopEx、DMUS_SEGF_FLAGS