Método IMFTopoLoader::Load (mfidl.h)

Cria uma topologia totalmente carregada da topologia parcial de entrada.

Sintaxe

HRESULT Load(
  [in]  IMFTopology *pInputTopo,
  [out] IMFTopology **ppOutputTopo,
  [in]  IMFTopology *pCurrentTopo
);

Parâmetros

[in] pInputTopo

Um ponteiro para a interface IMFTopology da topologia parcial a ser resolvida.

[out] ppOutputTopo

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

[in] pCurrentTopo

Um ponteiro para a interface IMFTopology da topologia completa anterior. O carregador de topologia pode reutilize objetos dessa topologia na nova topologia. Este parâmetro pode ser NULL. Consulte Observações.

Valor retornado

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

Comentários

Esse método cria transformações intermediárias necessárias para concluir a topologia. Ele também define os tipos de mídia de entrada e saída em todos os objetos na topologia. Se o método for bem-sucedido, a topologia completa será retornada no parâmetro ppOutputTopo .

Você pode usar o parâmetro pCurrentTopo para fornecer uma topologia completa que foi carregada anteriormente. Se essa topologia contiver objetos necessários na nova topologia, o carregador de topologia poderá reutilizá-los sem criá-los novamente. Esse cache pode potencialmente tornar o processo mais rápido. Os objetos de pCurrentTopo não serão reconfigurados, portanto, você pode especificar uma topologia que esteja transmitindo dados ativamente. Por exemplo, enquanto uma topologia ainda está em execução, você pode pré-carregar a próxima topologia.

Antes de chamar esse método, você deve garantir que os nós de saída na topologia parcial tenham ponteiros IMFStreamSink válidos, não IMFActivate pointers. A Sessão de Mídia executa automaticamente essa ação dentro do método IMFMediaSession::SetTopology . No entanto, se você chamar Load antes de chamar SetTopology, deverá associar os nós de saída manualmente. Para obter mais informações, consulte Associando nós de saída a coletores de mídia.

Requisitos

Confira também

Edifício avançado de topologia

IMFTopoLoader

Topologias