Método IMFMediaSession::GetFullTopology (mfidl.h)

Obtiene una topología de la sesión multimedia.

Este método puede obtener la topología actual o una topología en cola.

Sintaxis

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

Parámetros

[in] dwGetFullTopologyFlags

OR bit a bit de cero o más marcas de la enumeración MFSESSION_GETFULLTOPOLOGY_FLAGS.

[in] TopoId

Identificador de la topología. Este parámetro se omite si el parámetro dwGetFullTopologyFlags contiene la marca MFSESSION_GETFULLTOPOLOGY_CURRENT . Para obtener el identificador de una topología, llame a IMFTopology::GetTopologyID.

[out] ppFullTopology

Recibe un puntero a la interfaz IMFTopology de la topología. El autor de la llamada debe liberar la interfaz .

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
MF_E_SHUTDOWN	Se ha cerrado la sesión multimedia.

Comentarios

Si la marca MFSESSION_GETFULLTOPOLOGY_CURRENT se especifica en el parámetro dwGetFullTopologyFlags , el método devuelve la topología de la presentación actual. De lo contrario, el método busca en todas las topologías en cola una que coincida con el identificador especificado en el parámetro TopoId .

Este método se puede usar para recuperar la topología de la presentación actual o cualquier presentación pendiente. No se puede usar para recuperar una topología que ya ha finalizado.

La topología devuelta en ppFullTopo es una topología completa, no una topología parcial.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	mfidl.h
Library	Mfuuid.lib

Consulte también

IMFMediaSession

TOPOID