次の方法で共有

IAMTimelineComp::VTrackInsBefore

  • [アーティクル]

VTrackInsBefore メソッドは、コンポジションに指定の優先順位で仮想トラックを挿入する。

構文

  HRESULT VTrackInsBefore(
    IAMTimelineObj *pVirtualTrack,
    long Priority
);

パラメータ

pVirtualTrack

仮想トラックの IAMTimelineObj インターフェイスへのポインタ。

Priority

仮想トラックを挿入する優先順位。優先順位リストの最後に仮想トラックを挿入する場合は -1。優先順位リストにより、表示されるクリップが決まる。詳細については、「注意」を参照すること。

戻り値

次のいずれかの HRESULT 値を返す。

戻りコード 説明
S_OK 成功。
E_INVALIDARG 無効な引数。
E_NOINTERFACE オブジェクトは仮想トラックではない。

注意

コンポジション内の各仮想トラックには、固有の優先順位レベルが割り当てられている。優先順位レベルの範囲は 0 ～ n - 1 で、n はコンポジション内の仮想トラックの数である。ビデオ グループでは、トラックが空の場所、またはトラックにトランジションが含まれている場所を除き、優先順位の低い仮想トラックは高いトラックによって隠される。仮想トラックは、最終的なコンポジションのレイヤと考えることができる。トラック 1 はトラック 0 の上のレイヤ、トラック 2 はトラック 1 の上のレイヤ、というようになる。

Priority パラメータに -1 を指定すると、その仮想トラックはリストの最後に挿入されて、既存のどのトラックより優先順位の値が高くなる。コンポジション内に既に存在する優先順位値を指定すると、それ以上の優先順位を持つすべてのトラックが、1 つ上の優先順位レベルに移動する。

例: トラック A の優先順位が 0 で、トラック B の優先順位が 1 であるものとする。トラック C を優先順位 0 で挿入すると、トラック A の優先順位は 1 になり、トラック B の優先順位は 2 になる。

コンポジション内の現在のトラック数より大きい値を優先順位に指定すると、このメソッドは失敗する。

要件

ヘッダー : Qedit.h をインクルードする。このヘッダー ファイルは、バージョン 7 以降の Microsoft® Direct3D® のヘッダーとは互換性がない。

ライブラリ : strmiids.lib を使用。

参照