IMFByteStream::BeginWrite method (mfobjects.h)

Artikel
03/04/2024

Memulai operasi penulisan asinkron ke aliran.

Sintaks

HRESULT BeginWrite(
  [in] const BYTE       *pb,
  [in] ULONG            cb,
  [in] IMFAsyncCallback *pCallback,
  [in] IUnknown         *punkState
);

Parameter

[in] pb

Arahkan ke buffer yang berisi data untuk ditulis.

[in] cb

Ukuran buffer dalam byte.

[in] pCallback

Arahkan ke antarmuka IMFAsyncCallback dari objek panggilan balik. Pemanggil harus mengimplementasikan antarmuka ini.

[in] punkState

Penunjuk ke antarmuka IUnknown dari objek status, yang ditentukan oleh pemanggil. Parameter ini bisa NULL. Anda dapat menggunakan objek ini untuk menyimpan informasi status. Objek dikembalikan ke pemanggil ketika panggilan balik dipanggil.

Nilai kembali

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Ketika semua data telah ditulis ke aliran, metode IMFAsyncCallback::Invoke objek panggilan dipanggil. Pada saat itu, aplikasi harus memanggil IMFByteStream::EndWrite untuk menyelesaikan permintaan asinkron.

Jangan mengalokasikan ulang, membebaskan, atau menulis ke buffer saat penulisan asinkron masih tertunda.

Catatan implementasi:Metode ini harus memperbarui posisi saat ini dalam aliran dengan menambahkan jumlah byte yang akan ditulis ke aliran, yang ditentukan oleh nilai yang dikembalikan dalam pcbWritten, ke posisi saat ini. Metode lain yang dapat memperbarui posisi saat ini adalah Read, BeginRead, Write, Seek, dan SetCurrentPosition.

Antarmuka ini tersedia pada platform berikut jika komponen yang dapat didistribusikan ulang Windows Media Format 11 SDK diinstal:

Windows XP dengan Paket Layanan 2 (SP2) dan yang lebih baru.
Windows XP Media Center Edition 2005 dengan KB900325 (Windows XP Media Center Edition 2005) dan KB925766 (Rollup Pembaruan Oktober 2006 untuk Windows XP Media Center Edition) terinstal.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	mfobjects.h (termasuk Mfidl.h)
Pustaka	Mfuuid.lib

Lihat juga

IMFByteStream

Bagikan melalui