IMFCaptureSource::AddEffect-Methode (mfcaptureengine.h)

Fügt einem Erfassungsdatenstrom einen Effekt hinzu.

Syntax

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

Parameter

[in] dwSourceStreamIndex

Der Aufzeichnungsdatenstrom. Der Wert kann einer der folgenden Werte sein.

Wert Bedeutung
0–0xFFFFFFFB
Der nullbasierte Index eines Datenstroms. Rufen Sie ZUM Abrufen der Anzahl der Streams 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 eine der folgenden Optionen:

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

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

Hinweise

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

Der Effekt wird auf den Stream angewendet, bevor die Daten die Erfassungssenken erreichen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile mfcaptureengine.h

Weitere Informationen

IMFCaptureSource