Microsoft DirectX 8.0

IAMTimelineEffectable オブジェクト

Microsoft® DirectShow 編集サービス (DES) のタイムライン オブジェクトにエフェクトを追加するためのメソッド、およびオブジェクトのエフェクトを操作するメソッドを提供する。ソース、トラック合成など、適用するエフェクトを持つことのできるタイムライン オブジェクトに適用される。

メソッド

EffectGetCountこのオブジェクトに適用されるエフェクトの数を取得する。
EffectInsBefore指定された優先順位のオブジェクトにエフェクトを挿入する。
EffectSwapPriorities2 つのエフェクトの優先順位レベルを入れ替える。
GetEffect指定された優先順位レベルのエフェクトを取得する。

EffectGetCount メソッド (IAMTimelineEffectable オブジェクト)

IAMTimelineEffectable オブジェクト

このオブジェクトに適用されるエフェクトの数を取得する。

構文

object.EffectGetCount(
pCount As Long
)

パラメータ

object
結果が IAMTimelineEffectable オブジェクトになるオブジェクト式。
pCount
エフェクトの数を受け取る変数。

エラー コード

メソッドでの処理が失敗すると、エラーが発生する。

IAMTimelineEffectable::EffectInsBefore メソッド (IAMTimelineEffectable オブジェクト)

IAMTimelineEffectable インターフェイス

指定された優先順位のオブジェクトにエフェクトを挿入する。

構文

object.EffectInsBefore(
pFX As AMTimelineObj,
Priority As Long
)

パラメータ

object
結果が IAMTimelineEffectable オブジェクトになるオブジェクト式。
pFX
エフェクトを指定する AMTimelineObj オブジェクト。
Priority
エフェクトを挿入する優先順位レベル。エフェクトを優先順位リストの最後に挿入する場合は、値として -1 を使用する。

エラー コード

メソッドでの処理が失敗するとエラーが発生し、Err.Number には次の値が設定される場合がある。

E_NOTIMPLpFX で指定されているオブジェクトがエフェクトではない。

注意

エフェクトの開始タイムと終了タイムは、必要に応じて、オブジェクトの時間範囲の境界内に収められる。

指定された優先順位レベルのエフェクトが既に存在する場合、優先順位リストのその位置以下のエフェクトがすべて 1 レベルずつ繰り下げられ、新しいエフェクトの場所が確保される。

IAMTimelineEffectable::EffectSwapPriorities メソッド (IAMTimelineEffectable オブジェクト)

IAMTimelineEffectable インターフェイス

2 つのエフェクトの優先順位レベルを入れ替える。

このメソッドは、指定された 2 つの優先順位レベルを持つそれぞれのエフェクトの優先順位を入れ替える。このメソッドから戻った時点では、最初に指定された優先順位にあったエフェクトの優先順位は、2 番目に指定された優先順位レベルになり、2 番目に指定された優先順位にあったエフェクトの優先順位は、最初に指定された優先順位レベルになっている。

構文

object.EffectSwapPriorities(
PriorityA As Long,
PriorityB As Long
)

パラメータ

object
結果が IAMTimelineEffectable オブジェクトになるオブジェクト式。
PriorityA
エフェクトを入れ替える最初の優先順位レベル。
PriorityB
エフェクトを入れ替える 2 番目の優先順位レベル。

エラー コード

メソッドが失敗すると、エラーが発生し、Err.Number には次の値が設定される場合がある。

E_INVALIDARG無効な引数。

IAMTimelineEffectable::GetEffect メソッド (IAMTimelineEffectable オブジェクト)

IAMTimelineEffectable インターフェイス

指定された優先順位レベルのエフェクトを取得する。

構文

object.GetEffect(
ppFx As AMTimelineObj,
Which As Long
)

パラメータ

object
結果が IAMTimelineEffectable オブジェクトになるオブジェクト式。
ppFX
エフェクトを受け取る AMTimelineObj オブジェクト。
Which
取得するエフェクトの優先順位レベル。

エラー コード

メソッドでの処理が失敗すると、エラーが発生する。