IEnumMediaTypes::Metode kloning (strmif.h)

[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Pengambilan 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 Pengambilan Audio/Video 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.]

Metode ini Clone membuat salinan enumerator. Objek yang dikembalikan dimulai dengan status enumerasi yang sama dengan aslinya.

Sintaks

HRESULT Clone(
  [out] IEnumMediaTypes **ppEnum
);

Parameter

[out] ppEnum

Menerima penunjuk ke antarmuka IEnumMediaTypes dari enumerator baru. Pemanggil harus merilis antarmuka.

Mengembalikan nilai

Mengembalikan salah satu nilai HRESULT berikut.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
E_OUTOFMEMORY	Memori tidak cukup.
E_POINTER	Argumen pointer NULL.
VFW_E_ENUM_OUT_OF_SYNC	Status pin telah berubah dan sekarang tidak konsisten dengan enumerator.

Keterangan

Jika kumpulan jenis media berubah, enumerator tidak lagi konsisten dengan pin, dan metode mengembalikan VFW_E_ENUM_OUT_OF_SYNC. Buang data apa pun yang diperoleh dari panggilan sebelumnya ke enumerator, karena mungkin tidak valid. Perbarui enumerator dengan memanggil metode Reset . Anda kemudian dapat memanggil metode dengan Clone aman.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	strmif.h (termasuk Dshow.h)
Pustaka	Strmiids.lib

Lihat juga

Menghitung Jenis Media

Kode Kesalahan dan Keberhasilan

Antarmuka IEnumMediaTypes