Freigeben über


IMFCaptureSource::AddEffect-Methode (mfcaptureengine.h)

Fügt einem Aufnahmedatenstrom einen Effekt hinzu.

Syntax

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

Die Parameter

[in] dwSourceStreamIndex

Der Aufnahmedatenstrom. Der Wert kann eine der folgenden Sein:

Wert Bedeutung
0–0xFFFFFFFB
Der nullbasierte Index eines Datenstroms. Rufen Sie ZUM Abrufen der Anzahl der Datenströme IMFCaptureSource::GetDeviceStreamCount auf.
MF_CAPTURE_ENGINE_FIRST_SOURCE_PHOTO_STREAM
0xFFFFFFFB
Der erste Bilddatenstrom.
MF_CAPTURE_ENGINE_FIRST_SOURCE_VIDEO_STREAM
0xFFFFFFFC
Der erste Videostream.
MF_CAPTURE_ENGINE_FIRST_SOURCE_AUDIO_STREAM
0xFFFFFFFD
Der erste Audiodatenstrom.

[in] pUnknown

Ein Zeiger auf einen der folgenden Optionen:

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode Description
S_OK
Erfolg.
MF_E_INVALIDMEDIATYPE
Es wurde kein kompatibler Medientyp gefunden.
MF_E_INVALIDSTREAMNUMBER
Der dwSourceStreamIndex-Parameter ist ungültig.

Bemerkungen

Der Effekt muss als Media Foundation Transform (MFT) implementiert werden. Der pUnknown-Parameter kann auf eine Instanz des MFT oder auf ein Aktivierungsobjekt für die MFT verweisen. Weitere Informationen finden Sie unter Activation Objects.

Der Effekt wird auf den Datenstrom angewendet, bevor die Daten die Aufnahmesenken erreichen.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows 8 [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2012 [nur Desktop-Apps]
Zielplattform Fenster
Header mfcaptureengine.h

Siehe auch

IMFCaptureSource-