Metodo IMFTopologyNode::ConnectOutput (mfidl.h)

Articolo
03/15/2023

Connette un flusso di output da questo nodo al flusso di input di un altro nodo.

Sintassi

HRESULT ConnectOutput(
  [in] DWORD           dwOutputIndex,
  [in] IMFTopologyNode *pDownstreamNode,
  [in] DWORD           dwInputIndexOnDownstreamNode
);

Parametri

[in] dwOutputIndex

Indice in base zero del flusso di output in questo nodo.

[in] pDownstreamNode

Puntatore all'interfaccia IMFTopologyNode del nodo a cui connettersi.

[in] dwInputIndexOnDownstreamNode

Indice in base zero del flusso di input nell'altro nodo.

Valore restituito

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

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_FAIL	Il metodo non è riuscito.
E_INVALIDARG	Parametro non valido.

Commenti

Le connessioni del nodo rappresentano il flusso di dati da un nodo al successivo. I flussi sono logici e vengono specificati dall'indice.

Se il nodo è già connesso all'output specificato, il metodo interrompe la connessione esistente. Se dwOutputIndex o dwInputIndexIndexOnDownstreamNode specificare i flussi che non esistono ancora, il metodo aggiunge il numero di flussi necessari.

Questo metodo verifica alcune condizioni non valide:

Un nodo di output non può avere connessioni di output. Se si chiama questo metodo in un nodo di output, il metodo restituisce E_FAIL.
Un nodo non può essere connesso a se stesso. Se pDownstreamNode specifica lo stesso nodo della chiamata al metodo, il metodo restituisce E_INVALIDARG.

Tuttavia, se il metodo ha esito positivo, non garantisce che la connessione del nodo sia valida. È possibile creare una topologia parziale che il caricatore della topologia non può risolvere. In tal caso, il metodo IMFTopoLoader::Load avrà esito negativo.

Per interrompere una connessione al nodo esistente, chiamare IMFTopologyNode::D isconnectOutput.

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mfidl.h
Libreria	Mfuuid.lib

Vedi anche

IMFTopologyNode

Topologie

Condividi tramite