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 |
|---|---|
|
Berhasil. |
|
Memori tidak cukup. |
|
Argumen pointer NULL. |
|
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 |