IMFCaptureSource::AddEffect-Methode (mfcaptureengine.h)

Artikel
03/01/2024

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:

Eine Media Foundation-Transformation (MFT), die die IMFTransform-Schnittstelle verfügbar macht.
Ein MFT-Aktivierungsobjekt, das die IMFActivate-Schnittstelle verfügbar macht .

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

Freigeben über