Método IMFSequencerSource::AppendTopology (mfidl.h)
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 |
|---|---|
|
O método foi bem-sucedido. |
|
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 |