Microsoft DirectX 8.0 |
Microsoft® DirectShow 編集サービス (DES) のタイムライン オブジェクトにエフェクトを追加するためのメソッド、およびオブジェクトのエフェクトを操作するメソッドを提供する。ソース、トラック、合成など、適用するエフェクトを持つことのできるタイムライン オブジェクトに適用される。
メソッド
EffectGetCount このオブジェクトに適用されるエフェクトの数を取得する。 EffectInsBefore 指定された優先順位のオブジェクトにエフェクトを挿入する。 EffectSwapPriorities 2 つのエフェクトの優先順位レベルを入れ替える。 GetEffect 指定された優先順位レベルのエフェクトを取得する。
このオブジェクトに適用されるエフェクトの数を取得する。
構文
object.EffectGetCount( pCount As Long )
パラメータ
- object
- 結果が IAMTimelineEffectable オブジェクトになるオブジェクト式。
- pCount
- エフェクトの数を受け取る変数。
エラー コード
メソッドでの処理が失敗すると、エラーが発生する。
IAMTimelineEffectable インターフェイス
指定された優先順位のオブジェクトにエフェクトを挿入する。
構文
object.EffectInsBefore( pFX As AMTimelineObj, Priority As Long )
パラメータ
- object
- 結果が IAMTimelineEffectable オブジェクトになるオブジェクト式。
- pFX
- エフェクトを指定する AMTimelineObj オブジェクト。
- Priority
- エフェクトを挿入する優先順位レベル。エフェクトを優先順位リストの最後に挿入する場合は、値として -1 を使用する。
エラー コード
メソッドでの処理が失敗するとエラーが発生し、Err.Number には次の値が設定される場合がある。
E_NOTIMPL pFX で指定されているオブジェクトがエフェクトではない。
注意
エフェクトの開始タイムと終了タイムは、必要に応じて、オブジェクトの時間範囲の境界内に収められる。
指定された優先順位レベルのエフェクトが既に存在する場合、優先順位リストのその位置以下のエフェクトがすべて 1 レベルずつ繰り下げられ、新しいエフェクトの場所が確保される。
IAMTimelineEffectable インターフェイス
2 つのエフェクトの優先順位レベルを入れ替える。
このメソッドは、指定された 2 つの優先順位レベルを持つそれぞれのエフェクトの優先順位を入れ替える。このメソッドから戻った時点では、最初に指定された優先順位にあったエフェクトの優先順位は、2 番目に指定された優先順位レベルになり、2 番目に指定された優先順位にあったエフェクトの優先順位は、最初に指定された優先順位レベルになっている。
構文
object.EffectSwapPriorities( PriorityA As Long, PriorityB As Long )
パラメータ
- object
- 結果が IAMTimelineEffectable オブジェクトになるオブジェクト式。
- PriorityA
- エフェクトを入れ替える最初の優先順位レベル。
- PriorityB
- エフェクトを入れ替える 2 番目の優先順位レベル。
エラー コード
メソッドが失敗すると、エラーが発生し、Err.Number には次の値が設定される場合がある。
E_INVALIDARG 無効な引数。
IAMTimelineEffectable インターフェイス
指定された優先順位レベルのエフェクトを取得する。
構文
object.GetEffect( ppFx As AMTimelineObj, Which As Long )
パラメータ
- object
- 結果が IAMTimelineEffectable オブジェクトになるオブジェクト式。
- ppFX
- エフェクトを受け取る AMTimelineObj オブジェクト。
- Which
- 取得するエフェクトの優先順位レベル。
エラー コード
メソッドでの処理が失敗すると、エラーが発生する。