Platform SDK: DirectX

DirectMusicPerformance.PlaySegment

DirectMusicPerformance.PlaySegment メソッドは、セグメントの再生を開始する。

object.PlaySegment(segment As DirectMusicSegment, _
    lFlags As Long, _
    startTime As Long) As DirectMusicSegmentState

パラメータ

object
DirectMusicPerformance オブジェクトを表すオブジェクト式。
segment
演奏される DirectMusicSegment オブジェクト。
lFlags
メソッドの動作を変更するフラグ。「CONST_DMUS_SEGF_FLAGS」を参照すること。
startTime
セグメントの演奏が開始されるタイム。lFlags で指定する任意の分解能境界に調整される。DMUS_SEGF_REFTIME フラグがセットされていない限り、タイムはミュージック タイムで表される。値が 0 の場合、セグメントの演奏はできる限り早く開始される。

戻り値

成功すれば、演奏中のセグメントを表す DirectMusicSegmentState オブジェクトを返す。

エラー コード

失敗すればエラーが発生し、Err.Number に次の値のいずれかが設定される。

DMUS_E_OUTOFMEMORY
DMUS_E_NO_MASTER_CLOCK
DMUS_E_SEGMENT_INIT_FAILED
DMUS_E_TIME_PAST

注意

セグメントの長さは 250 ミリ秒 (ms) を超えているべきである。

lFlags の境界分解能は、現在演奏されているプライマリ セグメントに関連するものである。

プライマリ セグメントの演奏が、別のプライマリ セグメントの演奏中にスケジュール設定されている場合、後に演奏されるセグメントに DMUS_SEGF_QUEUE フラグをセットしない限り、最初のセグメントは停止する。DMUS_SEGF_QUEUE フラグをセットした場合、2 つ目のセグメントは、最初のセグメントの演奏が終わると同時に演奏が開始される。

参照

DirectMusicPerformance.IsPlaying