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.

Value	Meaning
TRUE	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 Mecanismo de Mídia não puder adicionar o efeito, ocorrerá um erro de reprodução.

Esse método pode retornar um desses valores.

Código de retorno	Description
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.

Requirement	Value
Cliente mínimo suportado	Windows 8 [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo compatível	Windows Server 2012 [aplicativos da área de trabalho \| Aplicativos UWP]
da Plataforma de Destino	Windows
Header	mfmediaengine.h

Esta página foi útil?