MÉTHODE IMFMediaSession ::GetFullTopology (mfidl.h)

Obtient une topologie de la session multimédia.

Cette méthode peut obtenir la topologie actuelle ou une topologie mise en file d’attente.

Syntaxe

HRESULT GetFullTopology(
  [in]  DWORD       dwGetFullTopologyFlags,
  [in]  TOPOID      TopoId,
  [out] IMFTopology **ppFullTopology
);

Paramètres

[in] dwGetFullTopologyFlags

OR au niveau du bit de zéro ou plusieurs indicateurs de l’énumération MFSESSION_GETFULLTOPOLOGY_FLAGS.

[in] TopoId

Identificateur de la topologie. Ce paramètre est ignoré si le paramètre dwGetFullTopologyFlags contient l’indicateur MFSESSION_GETFULLTOPOLOGY_CURRENT . Pour obtenir l’identificateur d’une topologie, appelez IMFTopology ::GetTopologyID.

[out] ppFullTopology

Reçoit un pointeur vers l’interface IMFTopology de la topologie. L’appelant doit libérer l’interface.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Remarques

Si l’indicateur MFSESSION_GETFULLTOPOLOGY_CURRENT est spécifié dans le paramètre dwGetFullTopologyFlags , la méthode retourne la topologie de la présentation actuelle. Sinon, la méthode recherche dans toutes les topologies mises en file d’attente une qui correspond à l’identificateur donné dans le paramètre TopoId .

Cette méthode peut être utilisée pour récupérer la topologie de la présentation actuelle ou des présentations en attente. Il ne peut pas être utilisé pour récupérer une topologie qui est déjà terminée.

La topologie retournée dans ppFullTopo est une topologie complète, et non une topologie partielle.

Configuration requise

Voir aussi

IMFMediaSession

TOPOID