Kelas CMediaSample

[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.]

Kelas mendefinisikan CMediaSample sampel media yang mendukung antarmuka IMediaSample2 . Sampel media berisi penunjuk ke buffer memori, dan berbagai properti yang disimpan sebagai variabel anggota yang dilindungi.

Sampel media dibuat oleh alokator, yang berasal dari kelas CBaseAllocator . Konstruktor CMediaSample menerima pointer ke buffer yang dialokasikan, bersama dengan ukuran buffer. Properti lain biasanya diatur dan diambil melalui metode antarmuka IMediaSample .

Siklus hidup sampel media berbeda dari sebagian besar objek COM:

• Alokator menyimpan daftar sampel gratis. Saat filter membutuhkan sampel baru, filter memanggil metode IMemAllocator::GetBuffer alokator. Alokator mengambil sampel dari daftar gratisnya, menaikkan jumlah referensi sampel, dan mengembalikan pointer ke sampel.
• Setelah filter selesai dengan sampel, filter memanggil metode IUnknown::Release pada sampel. Tidak seperti kebanyakan objek, sampel tidak menghapus dirinya sendiri ketika jumlah referensinya mencapai nol. Sebaliknya, ia memanggil metode IMemAllocator::ReleaseBuffer pada alokator, dan alokator mengembalikan sampel ke daftar gratisnya.
• Alokator tidak menghancurkan sampel sampai metode IMemAllocator::D ecommit dipanggil.

Persyaratan