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.
| Código de retorno | Descrição |
|---|---|
|
O método foi bem-sucedido. |
|
Um ou mais nós de saída contêm IMFActivate pointers. O chamador deve associar os nós de saída aos coletores de mídia. Consulte Associando nós de saída a coletores de mídia. |
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
| 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 |