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

Crea una topología totalmente cargada a partir de la topología parcial de entrada.

Sintaxis

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

Parámetros

[in] pInputTopo

Puntero a la interfaz IMFTopology de la topología parcial que se va a resolver.

[out] ppOutputTopo

Recibe un puntero a la interfaz IMFTopology de la topología completada. El autor de la llamada debe liberar la interfaz .

[in] pCurrentTopo

Puntero a la interfaz IMFTopology de la topología completa anterior. El cargador de topologías puede volver a usar objetos de esta topología en la nueva topología. Este parámetro puede ser NULL. Vea la sección Comentarios.

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_TOPO_SINK_ACTIVATES_UNSUPPORTED	Uno o varios nodos de salida contienen punteros IMFActivate . El llamador debe enlazar los nodos de salida a receptores multimedia. Consulte Enlace de nodos de salida a receptores multimedia.

Comentarios

Este método crea las transformaciones intermedias necesarias para completar la topología. También establece los tipos de medios de entrada y salida en todos los objetos de la topología. Si el método se ejecuta correctamente, se devuelve la topología completa en el parámetro ppOutputTopo .

Puede usar el parámetro pCurrentTopo para proporcionar una topología completa que se cargó anteriormente. Si esta topología contiene objetos necesarios en la nueva topología, el cargador de topologías puede volver a usarlos sin volver a crearlos. Este almacenamiento en caché puede hacer que el proceso sea más rápido. Los objetos de pCurrentTopo no se volverán a configurar, por lo que puede especificar una topología que transmite datos activamente. Por ejemplo, mientras se sigue ejecutando una topología, puede cargar previamente la topología siguiente.

Antes de llamar a este método, debe asegurarse de que los nodos de salida de la topología parcial tengan punteros IMFStreamSink válidos, no punteros IMFActivate . La sesión multimedia realiza automáticamente esta acción dentro del método IMFMediaSession::SetTopology . Sin embargo, si llama a Load antes de llamar a SetTopology, debe enlazar manualmente los nodos de salida. Para obtener más información, consulte Enlace de nodos de salida a receptores multimedia.

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

Compilación de topología avanzada

IMFTopoLoader

Topologías