IMFFinalizableMediaSink::BeginFinalize method (mfidl.h)

Artikel
08/24/2023

Memberi tahu sink media untuk secara asinkron mengambil langkah apa pun yang diperlukan untuk menyelesaikan tugasnya.

Sintaks

HRESULT BeginFinalize(
  [in] IMFAsyncCallback *pCallback,
  [in] IUnknown         *punkState
);

Parameter

[in] pCallback

Penunjuk ke antarmuka IMFAsyncCallback dari objek asinkron. 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.

Menampilkan nilai

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.

Keterangan

Banyak sink media arsip memiliki langkah-langkah yang perlu mereka lakukan di akhir pengarsipan untuk menyelesaikan operasi file mereka, seperti memperbarui header (untuk beberapa format) atau membersihkan semua penulisan yang tertunda ke disk. Dalam beberapa kasus, ini mungkin termasuk operasi mahal seperti mengindeks konten. BeginFinalize adalah cara asinkron untuk memulai tugas akhir.

Ketika operasi finalisasi selesai, metode IMFAsyncCallback::Invoke objek panggilan dipanggil. Pada saat itu, aplikasi harus memanggil IMFFinalizableMediaSink::EndFinalize untuk menyelesaikan permintaan asinkron.

Persyaratan


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	mfidl.h
Pustaka	Mfuuid.lib

Lihat juga

IMFFinalizableMediaSink

Share via