Método IMFMediaEngineEx::InsertAudioEffect (mfmediaengine.h)

Inserta un efecto de audio.

Sintaxis

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

Parámetros

[in] pEffect

Uno de los siguientes:

  • Puntero a la interfaz IMFTransform de una transformación de Media Foundation (MFT) que implementa el efecto de audio.
  • Puntero a la interfaz IMFActivate de un objeto de activación. El objeto de activación debe crear un MFT para el efecto de audio.

[in] fOptional

Especifica si el efecto es opcional.

Valor Significado
VERDAD
El efecto es opcional. Si el motor multimedia no puede agregar el efecto, omite el efecto y continúa la reproducción.
FALSO
Se requiere el efecto. Si el objeto Media Engine no puede agregar el efecto, se produce un error de reproducción.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
Correcto.
MF_E_INVALIDREQUEST
Se alcanzó el número máximo de efectos de audio.

Comentarios

El efecto se aplica cuando se carga el siguiente recurso multimedia.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado mfmediaengine.h

Consulte también

IMFMediaEngineEx