Méthode IMFActivate ::ActivateObject (mfobjects.h)

Crée l’objet associé à cet objet d’activation.

Syntaxe

HRESULT ActivateObject(
  [in]  REFIID riid,
  [out] void   **ppv
);

Paramètres

[in] riid

Identificateur d’interface (IID) de l’interface demandée.

[out] ppv

Reçoit un pointeur vers l’interface demandée. L’appelant doit libérer l’interface.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Certains objets Microsoft Media Foundation doivent être arrêtés avant d’être libérés. Dans ce cas, l’appelant est responsable de l’arrêt de l’objet retourné dans ppv. Pour arrêter l’objet, effectuez l’une des opérations suivantes :

• Appelez IMFActivate ::ShutdownObject sur l’objet d’activation, ou
• Appelez la méthode d’arrêt spécifique à l’objet. Cette méthode dépend du type d’objet . Les possibilités sont les suivantes :
  • Sources des médias : Appelez IMFMediaSource ::Shutdown.
  • Récepteurs multimédias : Appelez IMFMediaSink ::Shutdown.
  • Tout objet qui prend en charge l’interface IMFShutdown : Appelez IMFShutdown ::Shutdown.

La méthode IMFActivate ::ShutdownObject est générique pour tous les types d’objets. Si l’objet ne nécessite pas de méthode d’arrêt, ShutdownObject réussit et n’a aucun effet. Si vous ne connaissez pas la méthode d’arrêt spécifique pour l’objet (ou si vous ne connaissez pas le type d’objet), appelez IMFActivate ::ShutdownObject.

Après le premier appel à ActivateObject, les appels suivants retournent un pointeur vers le même instance, jusqu’à ce que le client appelle ShutdownObject ou IMFActivate ::D etachObject.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau | applications UWP]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau | applications UWP]
Plateforme cible	Windows
En-tête	mfobjects.h
Bibliothèque	Mfuuid.lib

Voir aussi

Objets d’activation

IMFActiver