Compartilhar via

Método IMFSequencerSource::AppendTopology (mfidl.h)

  • Artigo

Adiciona uma topologia ao final da fila.

Sintaxe

HRESULT AppendTopology(
  [in]  IMFTopology          *pTopology,
  [in]  DWORD                dwFlags,
  [out] MFSequencerElementId *pdwId
);

Parâmetros

[in] pTopology

Ponteiro para a interface IMFTopology da topologia. Esse ponteiro não pode ser NULL. Se um aplicativo passar NULL, a chamada falhará com um código de erro E_INVALIDARG.

[in] dwFlags

Uma combinação de sinalizadores da enumeração MFSequencerTopologyFlags .

[out] pdwId

Recebe o identificador de elemento sequencer para essa topologia.

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
S_OK
 O método foi bem-sucedido.
MF_E_ATTRIBUTENOTFOUND
 O nó de topologia de origem não tem um dos seguintes atributos:

Comentários

O sequenciador reproduz topologias na ordem em que estão na fila. Você pode enfileirar quantas topologias quiser pré-registrar.

O aplicativo deve indicar ao sequenciador quando tiver enfileirado a última topologia na Sessão de Mídia. Para especificar a última topologia, defina o sinalizador SequencerTopologyFlags_Last no parâmetro dwFlags ao acrescentar a topologia. O sequenciador usa essas informações para encerrar a reprodução com o pipeline. Caso contrário, o sequenciador aguarda indefinidamente que uma nova topologia seja enfileirada.

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

Confira também

Sobre a origem do sequenciador

IMFSequencerSource

MFCreateTopologyNode