Bagikan melalui

Antarmuka IMFSampleOutputStream (mfobjects.h)

  • Artikel

Menulis sampel media ke aliran byte.

Warisan

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

Metode

Antarmuka IMFSampleOutputStream memiliki metode ini.

 
IMFSampleOutputStream::BeginWriteSample

Memulai permintaan asinkron untuk menulis sampel media ke aliran.
IMFSampleOutputStream::EndWriteSample

Menyelesaikan permintaan asinkron untuk menulis sampel media ke aliran.

Keterangan

Aliran byte yang dapat ditulis dapat secara opsional mengimplementasikan antarmuka ini.

Antarmuka ini memungkinkan pemanggil mengirim sampel media ke aliran byte untuk ditulis, alih-alih menggunakan metode IMFByteStream::BeginWrite untuk menulis blob data yang tidak diketik. Aliran byte dapat menggunakan informasi yang terkandung dalam sampel media untuk mengoptimalkan cara menulis data. Misalnya, aliran byte yang mengirim data media melalui jaringan dapat dioptimalkan berdasarkan stempel waktu.

Untuk mendapatkan penunjuk ke antarmuka ini, panggil QueryInterface pada objek aliran byte.

Setiap implementasi IMFByteStream yang mengekspos IMFSampleOutputStream sebagai antarmuka perlu mematuhi persyaratan berikut:

  • Semua penulisan dari salah satu antarmuka selalu masuk ke objek aliran byte yang sama persis.
  • Posisi saat ini untuk IMFSampleOutputStream dan IMFByteStream harus selalu sama. Misalnya, menulis ke IMFSampleOutputStream juga akan memperbarui posisi IMFByteStream saat ini.
  • Menulis sampel menggunakan BeginWriteSample dan EndWriteSample harus menserialisasikan sampel dengan menulis data dari semua buffer dalam sampel, dalam urutan di mana buffer disimpan dalam sampel. (Gunakan IMFSample::GetBufferByIndex untuk mendapatkan buffer individual menurut nilai indeks.) Total byte yang disalin adalah jumlah byte yang ditulis dari semua buffer.

Persyaratan

   
Klien minimum yang didukung Windows 8 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2012 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header mfobjects.h (termasuk Mfidl.h)

Lihat juga

Antarmuka Media Foundation