Partager via


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 :

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