Partager via

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

  • Article

Insère un effet audio.

Syntaxe

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

Paramètres

[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.

Valeur retournée

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.

Remarques

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

Configuration requise

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

Voir aussi

IMFMediaEngineEx