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 |
|---|---|
|
El método se ha llevado a cabo de forma correcta. |
|
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 |