Microsoft DirectX 8.0 (C++)

IDirectMusicPerformance8::StopEx

オブジェクトの再生を停止する。

HRESULT StopEx(
  IUnknown *pObjectToStop,
  __int64 i64StopTime, 
  DWORD dwFlags
);

パラメータ

pObjectToStop
停止するセグメント、セグメント状態、またはオーディオパスの IUnknown インターフェイスへのポインタ。
i64StopTime
停止するタイム。このタイムが過去のタイムである場合や、値として 0 を指定した場合は、オブジェクトの演奏が即座に停止される。
dwFlags
演奏の停止タイムを指定するフラグ。境界は現在のプライマリ セグメントに関連する。次のいずれかの値か、DMUS_SEGF_REFTIME に別のフラグを組み合わせることができる。
0
即座に停止する。
DMUS_SEGF_AUTOTRANSITION
無音へのトランジションをアレンジして演奏する。ソングを停止する場合にのみ有効である。DirectX 8.0 では実装されない。
DMUS_SEGF_BEAT
次の拍境界で、または i64StopTime の後に停止する。
DMUS_SEGF_DEFAULT
IDirectMusicSegment8::SetDefaultResolution メソッドで設定されたデフォルト境界で停止する。
DMUS_SEGF_GRID
次のグリッド境界で、または i64StopTime の後に停止する。
DMUS_SEGF_MEASURE
次の小節境界で、または i64StopTime の後に停止する。
DMUS_SEGF_REFTIME
i64StopTime の値は基準タイムである。
DMUS_SEGF_SEGMENTEND
プライマリ セグメントの最後で停止する。
DMUS_SEGF_MARKER
次のマーカーで停止する。

戻り値

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

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

注意

セグメントを停止すると、演奏中のすべてのインスタンスが停止する。

動作環境

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

参照

IDirectMusicPerformance8::StopIDirectMusicPerformance8::PlaySegmentExDMUS_SEGF_FLAGS