Bagikan melalui

METODE IMFCaptureSource::AddEffect (mfcaptureengine.h)

  • Artikel

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