IDirectMusicPerformance8::StopEx

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

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

メソッドのインデックス： 46

パラメータ

pObject

停止するオブジェクト（セグメント、セグメント状態、オーディオパスのいずれか）の IUnknown インターフェイスへのポインタを指定します。

i64StopTime

停止するタイムを指定します。このタイムが過去のタイムである場合や、値として 0 を指定した場合には、オブジェクトの演奏が即座に停止されます。

dwFlags

演奏の停止タイムを指定するフラグ値を指定します。

以下の値のいずれかの値か、DMUS_SEGF_REFTIME と別のフラグいずれか1つを組み合わせた値を指定できます。

値	機能
0	直ちに停止します。
0x40 (DMUS_SEGF_REFTIME)	`i64StopTime` の値は基準タイムであることを指定します。このフラグが指定されない場合は `i64StopTime` の値はミュージックタイムです。
0x800 (DMUS_SEGF_GRID)	`i64StopTime` の位置にある、またはそれ以降の次のグリッド境界で停止します。
0x1000 (DMUS_SEGF_BEAT)	`i64StopTime` の位置にある、またはそれ以降の次の拍境界で停止します。
0x2000 (DMUS_SEGF_MEASURE)	`i64StopTime` の位置にある、またはそれ以降の次の小節境界で停止します。
0x4000 (DMUS_SEGF_DEFAULT)	デフォルト境界で停止します。
0x800000 (DMUS_SEGF_SEGMENTEND)	プライマリセグメントの最後で停止します。
0x1000000 (DMUS_SEGF_MARKER)	次のマーカーで停止します。

成功すると 0x00000000 (S_OK) が返ります。

無効なポインタが渡されたことで失敗すると 0x80004003 (E_POINTER) が返ります。