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

Obtém uma topologia da Sessão de Mídia.

Esse método pode obter a topologia atual ou uma topologia na fila.

Sintaxe

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

Parâmetros

[in] dwGetFullTopologyFlags

OR bit a bit de zero ou mais sinalizadores da enumeração MFSESSION_GETFULLTOPOLOGY_FLAGS.

[in] TopoId

O identificador da topologia. Esse parâmetro será ignorado se o parâmetro dwGetFullTopologyFlags contiver o sinalizador MFSESSION_GETFULLTOPOLOGY_CURRENT . Para obter o identificador de uma topologia, chame IMFTopology::GetTopologyID.

[out] ppFullTopology

Recebe um ponteiro para a interface IMFTopology da topologia. O chamador deve liberar a interface.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
MF_E_SHUTDOWN	A Sessão de Mídia foi desligada.

Comentários

Se o sinalizador MFSESSION_GETFULLTOPOLOGY_CURRENT for especificado no parâmetro dwGetFullTopologyFlags , o método retornará a topologia para a apresentação atual. Caso contrário, o método pesquisa todas as topologias enfileiradas para uma que corresponda ao identificador especificado no parâmetro TopoId .

Esse método pode ser usado para recuperar a topologia da apresentação atual ou de qualquer apresentação pendente. Ele não pode ser usado para recuperar uma topologia que já foi encerrada.

A topologia retornada em ppFullTopo é uma topologia completa, não uma topologia parcial.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	mfidl.h
Biblioteca	Mfuuid.lib

Confira também

IMFMediaSession

TOPOID