Microsoft DirectX 8.0 (Visual Basic)

DirectMusicPerformance8.PlaySegmentEx

セグメントの再生を開始する。

object.PlaySegmentEx( _
  Source As Unknown, _
  lFlags As CONST_DMUS_SEGF_FLAGS, _
  StartTime As Long, _
  [From As Unknown], _
  [AudioPath As Unknown], _
) As DirectMusicSegmentState8

指定項目

object
DirectMusicPerformance8 オブジェクトを指定する。
Source
演奏する DirectMusicSegment8 オブジェクト。
lFlags
メソッドの動作を変更するフラグ。0、または CONST_DMUS_SEGF_FLAGS 列挙型の 1 つ以上の定数。
StartTime
セグメントの演奏が開始されるパフォーマンス タイム。lFlags で指定する任意の分解能境界に調整される。DMUS_SEGF_REFTIME フラグが設定されていない限り、タイムはミュージック タイムで表される。値が 0 の場合、セグメントの演奏はできる限り早く開始される。
From
新しいセグメントの開始時に演奏を停止するオプションの DirectMusicSegmentState8 または DirectMusicAudioPath8 オブジェクト。省略可。これがオーディオパスの場合は、そのオーディオパスで演奏されているすべてのセグメント状態が停止される。
AudioPath
どのオーディオパス上でセグメントを演奏するかを表す DirectMusicAudioPath8 オブジェクト。省略可。NULL を指定するか、省略する場合、セグメントはデフォルト パス上で演奏される。

戻り値

セグメントの演奏中のインスタンスを表す、DirectMusicSegmentState8 オブジェクトを返す。

エラー コード

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

DMUS_E_AUDIOPATH_INACTIVE
DMUS_E_AUDIOPATH_NOPORT
DMUS_E_NO_MASTER_CLOCK
DMUS_E_SEGMENT_INIT_FAILED
DMUS_E_TIME_PAST
DMUS_E_OUTOFMEMORY

注意

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

lFlags の境界分解能は、プライマリ セグメントに関連するものである。

あるプライマリ セグメントの演奏中に、別のプライマリ セグメントを演奏するスケジュールが設定される場合、後に演奏されるセグメントに DMUS_SEGF_QUEUE フラグを設定しない限り、先に演奏されるセグメントは停止する。フラグが設定されると、後のセグメントの演奏は、先のセグメントの演奏が終わってから開始される。

セグメントの正確な開始タイムの詳細については、「セグメントのタイミング」を参照すること。テンポの変更がセグメントの開始タイムに及ぼす影響については、「クロック タイムとミュージック タイム」を参照すること。

lFlags に DMUS_SEGF_AUTOTRANSITION が指定されているときに、StartTime で演奏中のセグメントを中断する場合、このメソッドは、2 つのセグメント間のトランジションをアレンジして、それを演奏した後に Source を演奏する。

Source がセグメントの場合は、Transition で指定されたテンプレートに基づくトランジション用のセグメントがアレンジされて演奏される。

参照

セグメントの使い方トランジションの使い方