IMFCaptureSource::AddEffect method (mfcaptureengine.h)

Menambahkan efek ke aliran pengambilan.

Syntax

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

Parameter-parameternya

[in] dwSourceStreamIndex

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

Nilai	Meaning
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.

Mengembalikan kode	Description
S_OK	Sukses.
MF_E_INVALIDMEDIATYPE	Tipe media yang kompatibel tidak dapat ditemukan.
MF_E_INVALIDSTREAMNUMBER	Parameter dwSourceStreamIndex tidak valid.

Komentar

Efeknya 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 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Platform Target	Windows
Header	mfcaptureengine.h

Lihat juga

IMFCaptureSource