Antarmuka IMediaSample (strmif.h)

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

Antarmuka IMediaSample mengatur dan mengambil properti pada sampel media. Sampel media adalah objek COM yang berisi blok data media. Sampel media mendukung penggunaan buffer memori bersama di antara filter.

Biasanya, aplikasi tidak memanggil metode pada antarmuka ini. Filter menggunakan antarmuka ini untuk mengatur properti pada sampel, dan mengirimkan sampel ke filter hilir. Filter hilir menggunakan antarmuka untuk mengambil properti dan membaca data. Filter dapat mengubah data di tempat, atau dapat menyalin sampel, memodifikasi salinan, dan meneruskan salinan hilir.

Antarmuka IMediaSample2 mewarisi antarmuka ini.

Warisan

Antarmuka IMediaSample mewarisi dari antarmuka IUnknown . IMediaSample juga memiliki jenis anggota ini:

Metode

Antarmuka IMediaSample memiliki metode ini.

IMediaSample::GetActualDataLength Metode GetActualDataLength mengambil panjang data yang valid di buffer.
IMediaSample::GetMediaTime Metode GetMediaTime mengambil waktu media untuk sampel ini.
IMediaSample::GetMediaType Metode GetMediaType mengambil jenis media, jika jenis media berbeda dari sampel sebelumnya.
IMediaSample::GetPointer Metode GetPointer mengambil penunjuk baca/tulis ke buffer sampel media.
IMediaSample::GetSize Metode GetSize mengambil ukuran buffer.
IMediaSample::GetTime Metode GetTime mengambil waktu streaming di mana sampel ini harus dimulai dan selesai.
IMediaSample::IsDiscontinuity Metode IsDiscontinuity menentukan apakah sampel ini mewakili jeda dalam aliran data.
IMediaSample::IsPreroll Metode IsPreroll menentukan apakah sampel ini adalah sampel pra-pendaftaran. Sampel pra-pendaftaran tidak boleh ditampilkan.
IMediaSample::IsSyncPoint Metode IsSyncPoint menentukan apakah awal sampel ini adalah titik sinkronisasi.
IMediaSample::SetActualDataLength Metode SetActualDataLength mengatur panjang data yang valid dalam buffer.
IMediaSample::SetDiscontinuity Metode SetDiscontinuity menentukan apakah sampel ini mewakili jeda dalam aliran data.
IMediaSample::SetMediaTime Metode SetMediaTime mengatur waktu media untuk sampel ini.
IMediaSample::SetMediaType Metode SetMediaType mengatur jenis media untuk sampel.
IMediaSample::SetPreroll Metode SetPreroll menentukan apakah sampel ini adalah sampel pra-pendaftaran.
IMediaSample::SetSyncPoint Metode SetSyncPoint menentukan apakah awal sampel ini adalah titik sinkronisasi.
IMediaSample::SetTime Metode SetTime mengatur waktu streaming saat sampel ini harus dimulai dan selesai.

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)