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::Stop、IDirectMusicPerformance8::PlaySegmentEx、DMUS_SEGF_FLAGS