Metodo IMFTopoLoader::Load (mfidl.h)

Crea una topologia completamente caricata dalla topologia parziale di input.

Sintassi

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

Parametri

[in] pInputTopo

Puntatore all'interfaccia IMFTo topologia della topologia parziale da risolvere.

[out] ppOutputTopo

Riceve un puntatore all'interfaccia FMTo topologia della topologia completata. Il chiamante deve rilasciare l'interfaccia.

[in] pCurrentTopo

Puntatore all'interfaccia IMFTo topologia della topologia completa precedente. Il caricatore della topologia può riutilizzare gli oggetti da questa topologia nella nuova topologia. Questo parametro può essere NULL. Vedere la sezione Osservazioni.

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Commenti

Questo metodo crea tutte le trasformazioni intermedie necessarie per completare la topologia. Imposta anche i tipi di supporti di input e output su tutti gli oggetti nella topologia. Se il metodo ha esito positivo, la topologia completa viene restituita nel parametro ppOutputTopo .

È possibile usare il parametro pCurrentTopo per fornire una topologia completa caricata in precedenza. Se questa topologia contiene oggetti necessari nella nuova topologia, il caricatore della topologia può riutilizzarli senza crearli di nuovo. Questa memorizzazione nella cache può potenzialmente rendere più veloce il processo. Gli oggetti da pCurrentTopo non verranno riconfigurati, quindi è possibile specificare una topologia che esegue attivamente lo streaming di dati. Ad esempio, mentre una topologia è ancora in esecuzione, è possibile pre-caricare la topologia successiva.

Prima di chiamare questo metodo, è necessario assicurarsi che i nodi di output nella topologia parziale dispongano di puntatori FMStreamSink validi, non dei puntatori FMActivate . La sessione multimediale esegue automaticamente questa azione all'interno del metodo IMFMediaSession::SetTopology . Tuttavia, se si chiama Load prima di chiamare SetTopology, è necessario associare manualmente i nodi di output. Per altre informazioni, vedere Associazione dei nodi di output ai sink multimediali.

Requisiti

Vedi anche

Compilazione avanzata della topologia

FMTopoLoader

Topologie