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

  • Artículo

Agrega una topología al final de la cola.

Sintaxis

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

Parámetros

[in] pTopology

Puntero a la interfaz IMFTopology de la topología. Este puntero no puede ser NULL. Si una aplicación pasa NULL, se produce un error en la llamada con un código de error E_INVALIDARG.

[in] dwFlags

Combinación de marcas de la enumeración MFSequencerTopologyFlags .

[out] pdwId

Recibe el identificador de elemento del secuenciador para esta topología.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.
MF_E_ATTRIBUTENOTFOUND
 Falta el nodo de topología de origen uno de los siguientes atributos:

Comentarios

El secuenciador reproduce topologías en el orden en que se ponen en cola. Puede poner en cola tantas topologías como desee inscribir previamente.

La aplicación debe indicar al secuenciador cuando ha puesto en cola la última topología en la sesión multimedia. Para especificar la última topología, establezca la marca SequencerTopologyFlags_Last en el parámetro dwFlags al anexar la topología. El secuenciador usa esta información para finalizar la reproducción con la canalización. De lo contrario, el secuenciador espera indefinidamente a que se pone en cola una nueva topología.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mfidl.h
Library Mfuuid.lib

Consulte también

Acerca del origen del secuenciador

IMFSequencerSource

MFCreateTopologyNode