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

Insère un effet audio.

Syntaxe

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

[in] pEffect

Celui-ci peut avoir l'une des valeurs suivantes :

Pointeur vers l’interface IMFTransform d’une transformation Media Foundation (MFT) qui implémente l’effet audio.
Pointeur vers l’interface IMFActivate d’un objet d’activation. L’objet d’activation doit créer un MFT pour l’effet audio.

[in] fOptional

Spécifie si l’effet est facultatif.

Valeur	Signification
VRAI	L’effet est facultatif. Si le moteur multimédia ne peut pas ajouter l’effet, il ignore l’effet et continue la lecture.
FAUX	L’effet est obligatoire. Si l’objet Media Engine ne peut pas ajouter l’effet, une erreur de lecture se produit.

Cette méthode peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	Réussite.
MF_E_INVALIDREQUEST	Le nombre maximal d’effets audio a été atteint.

L’effet est appliqué lors du chargement de la ressource multimédia suivante.

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	mfmediaengine.h