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

Insere um efeito de áudio.

Sintaxe

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

[in] pEffect

Um dos seguintes:

Um ponteiro para a interface IMFTransform de uma transformação do Media Foundation (MFT) que implementa o efeito de áudio.
Um ponteiro para a interface IMFActivate de um objeto de ativação. O objeto de ativação deve criar um MFT para o efeito de áudio.

[in] fOptional

Especifica se o efeito é opcional.

Valor	Significado
VERDADE	O efeito é opcional. Se o Mecanismo de Mídia não puder adicionar o efeito, ele ignorará o efeito e continuará a reprodução.
FALSE	O efeito é necessário. Se o objeto Media Engine não puder adicionar o efeito, ocorrerá um erro de reprodução.

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	Êxito.
MF_E_INVALIDREQUEST	O número máximo de efeitos de áudio foi atingido.

O efeito é aplicado quando o próximo recurso de mídia é carregado.

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2012 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	mfmediaengine.h