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.

Code de retour	Description
S_OK	S_OK
MF_E_SHUTDOWN	La session multimédia a été arrêtée.

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

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

Voir aussi

IMFMediaSession

TOPOID