Metode IAMTimelineComp::VTrackInsBefore

[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Tangkapan Audio/Video di Media Foundation. Fitur-fitur tersebut telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer, IMFMediaEngine dan Audio/Video Capture di Media Foundation alih-alih DirectShow, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]

Catatan

[Tidak digunakan lagi. API ini bisa dihapus dari Rilis Windows mendatang.]

 

Metode VTrackInsBefore menyisipkan trek virtual ke dalam komposisi pada prioritas yang ditentukan.

Sintaks

HRESULT VTrackInsBefore(
   IAMTimelineObj *pVirtualTrack,
   long           Priority
);

Parameter

pVirtualTrack

Arahkan ke antarmuka IAMTimelineObj dari trek virtual.

Prioritas

Prioritas untuk menyisipkan trek virtual, atau –1 untuk menyisipkan trek virtual di akhir daftar prioritas. Daftar prioritas menentukan klip mana yang terlihat. Lihat Keterangan untuk informasi selengkapnya.

Nilai kembali

Mengembalikan salah satu nilai HRESULT berikut ini:

Menampilkan kode	Deskripsi
S_OK	Berhasil.
E_INVALIDARG	Argumen tidak valid.
E_NOINTERFACE	Objek bukan trek virtual.

 

Keterangan

Setiap trek virtual dalam komposisi memiliki tingkat prioritas yang unik. Tingkat prioritas berkisar dari 0 hingga n - 1, di mana n adalah jumlah trek virtual dalam komposisi. Untuk grup video, trek virtual menyembunyikan trek virtual apa pun dengan tingkat prioritas yang lebih rendah, kecuali di tempat-tempat di mana trek kosong atau berisi transisi. Anda dapat menganggap trek virtual sebagai lapisan dalam komposisi akhir. Trek 1 berlapis di atas trek 0, trek 2 berlapis di atas trek 1, dan seterusnya.

Jika Anda menentukan -1 untuk parameter Prioritas , trek virtual disisipkan di akhir daftar, dengan nilai prioritas yang lebih tinggi daripada trek yang ada. Jika Anda menentukan nilai prioritas yang sudah ada dalam komposisi, setiap trek dengan prioritas yang sama atau lebih besar akan naik satu tingkat prioritas.

Contoh: Lacak A memiliki prioritas 0, dan lacak B memiliki prioritas 1. Jika trek C disisipkan pada prioritas 0, lacak A berpindah ke prioritas 1, dan lacak B berpindah ke prioritas 2.

Jika prioritas yang ditentukan lebih besar dari jumlah trek saat ini dalam komposisi, metode gagal.

Catatan

File header Qedit.h tidak kompatibel dengan header Direct3D yang lebih baru dari versi 7.

 

Catatan

Untuk mendapatkan Qedit.h, unduh Pembaruan SDK Microsoft Windows untuk Windows Vista dan .NET Framework 3.0. Qedit.h tidak tersedia di Microsoft Windows SDK untuk Windows 7 dan .NET Framework 3.5 Paket Layanan 1.

 

Persyaratan

Persyaratan	Nilai
Header	Qedit.h
Pustaka	Strmiids.lib

Lihat juga

Antarmuka IAMTimelineComp

Kode Kesalahan dan Keberhasilan