Metodo IMFMediaEngineEx::InsertVideoEffect (mfmediaengine.h)

Inserisce un effetto video.

Sintassi

HRESULT InsertVideoEffect(
  [in] IUnknown *pEffect,
  [in] BOOL     fOptional
);

[in] pEffect

I tipi validi sono:

Puntatore all'interfaccia IMFTransform di una trasformazione Media Foundation (MFT) che implementa l'effetto video.
Puntatore all'interfaccia IMFActivate di un oggetto attivazione. L'oggetto attivazione deve creare un MFT per l'effetto video.

[in] fOptional

Specifica se l'effetto è facoltativo.

Valore	Significato
VERO	L'effetto è facoltativo. Se il motore multimediale non può aggiungere l'effetto, ignora l'effetto e continua la riproduzione.
FALSE	L'effetto è obbligatorio. Se l'oggetto Motore multimediale non può aggiungere l'effetto, si verifica un errore di riproduzione.

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Operazione completata.
MF_E_INVALIDREQUEST	È stato raggiunto il numero massimo di effetti video.

L'effetto viene applicato quando viene caricata la risorsa multimediale successiva.

Requisito	Valore
Client minimo supportato	Windows 8 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2012 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	mfmediaengine.h