METODE IMFCaptureSink::P repare (mfcaptureengine.h)

Menyiapkan sink pengambilan dengan memuat komponen alur yang diperlukan, seperti encoder, prosesor video, dan sink media.

Sintaks

HRESULT Prepare();

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
MF_E_INVALIDREQUEST	Permintaan tidak valid.

Keterangan

Memanggil metode ini bersifat opsional. Metode ini memberi aplikasi kesempatan untuk mengonfigurasi komponen alur sebelum digunakan. Metode ini asinkron. Jika metode mengembalikan kode keberhasilan, pemanggil akan menerima peristiwa MF_CAPTURE_SINK_PREPARED melalui metode IMFCaptureEngineOnEventCallback::OnEvent . Setelah kejadian ini diterima, panggil IMFCaptureSink::GetService untuk mengonfigurasi komponen individual.

Sebelum memanggil metode ini, konfigurasikan sink pengambilan dengan menambahkan setidaknya satu aliran. Untuk menambahkan aliran, panggil IMFCaptureSink::AddStream.

Metode Persiapan gagal jika sink tangkapan saat ini sedang digunakan. Misalnya, memanggil Siapkan pada sink pratinjau gagal jika mesin penangkap saat ini melakukan pratinjau.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Target Platform	Windows
Header	mfcaptureengine.h

Lihat juga

IMFCaptureSink