Partager via


IMFMediaEngineEx ::InsertAudioEffect, méthode (mfmediaengine.h)

Insère un effet audio.

Syntaxe

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

Paramètres

[in] pEffect

L’une des opérations 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 Meaning
TRUE
L’effet est facultatif. Si le moteur multimédia ne peut pas ajouter l’effet, il ignore l’effet et continue la lecture.
FALSE
L’effet est requis. 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 Descriptif
S_OK
Opération réussie.
MF_E_INVALIDREQUEST
Le nombre maximal d’effets audio a été atteint.

Remarques

L’effet est appliqué lorsque la ressource multimédia suivante est chargée.

Spécifications

Requirement Valeur
Client minimum requis Windows 8 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau | Applications UWP]
plateforme cible Fenêtres
Header mfmediaengine.h

Voir aussi

IMFMediaEngineEx