METODE IMFCaptureSource::AddEffect (mfcaptureengine.h)

Artikel
02/28/2024

Menambahkan efek ke aliran pengambilan.

Sintaks

HRESULT AddEffect(
  [in] DWORD    dwSourceStreamIndex,
  [in] IUnknown *pUnknown
);

Parameter

[in] dwSourceStreamIndex

Aliran pengambilan. Nilainya bisa salah satu dari yang berikut ini.

Nilai	Makna
0–0xFFFFFFFB	Indeks aliran berbasis nol. Untuk mendapatkan jumlah aliran, panggil IMFCaptureSource::GetDeviceStreamCount.
MF_CAPTURE_ENGINE_FIRST_SOURCE_PHOTO_STREAM 0xFFFFFFFB	Aliran gambar pertama.
MF_CAPTURE_ENGINE_FIRST_SOURCE_VIDEO_STREAM 0xFFFFFFFC	Streaming video pertama.
MF_CAPTURE_ENGINE_FIRST_SOURCE_AUDIO_STREAM 0xFFFFFFFD	Aliran audio pertama.

[in] pUnknown

Penunjuk ke salah satu hal berikut ini:

Transformasi Media Foundation (MFT) yang mengekspos antarmuka IMFTransform .
Objek aktivasi MFT yang mengekspos antarmuka IMFActivate .

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
MF_E_INVALIDMEDIATYPE	Tipe media yang kompatibel tidak dapat ditemukan.
MF_E_INVALIDSTREAMNUMBER	Parameter dwSourceStreamIndex tidak valid.

Keterangan

Efek harus diimplementasikan sebagai Transformasi Yayasan Media (MFT). Parameter pUnknown dapat menunjuk ke instans MFT, atau ke objek aktivasi untuk MFT. Untuk informasi selengkapnya, lihat Objek Aktivasi.

Efek diterapkan ke aliran sebelum data mencapai sink pengambilan.

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

IMFCaptureSource

Bagikan melalui