Condividi tramite


Metodo IGraphBuilder::Render (strmif.h)

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il Render metodo compila un grafico di filtro che esegue il rendering dei dati da un pin di output specificato.

Sintassi

HRESULT Render(
  [in] IPin *ppinOut
);

Parametri

[in] ppinOut

Puntatore all'interfaccia IPin in un pin di output.

Valore restituito

Restituisce un VALORE HRESULT. Di seguito sono indicati alcuni valori possibili.

Codice restituito Descrizione
S_OK
Operazione completata.
VFW_S_AUDIO_NOT_RENDERED
Esito parziale; l'audio non è stato eseguito il rendering.
VFW_S_DUPLICATE_NAME
Successo; Filter Graph Manager ha modificato un nome di filtro per evitare la duplicazione.
VFW_S_PARTIAL_RENDER
Esito parziale; alcuni dei flussi in questo film sono in formato non supportato.
VFW_S_VIDEO_NOT_RENDERED
Esito parziale; il video non è stato eseguito il rendering.
E_ABORT
Operazione interrotta.
E_OUTOFMEMORY
Memoria insufficiente.
E_POINTER
Argomento puntatore NULL.
VFW_E_CANNOT_CONNECT
Non è possibile trovare alcuna combinazione di filtri intermedi per rendere la connessione.
VFW_E_CANNOT_RENDER
Non è possibile trovare alcuna combinazione di filtri per eseguire il rendering del flusso.
VFW_E_NO_ACCEPTABLE_TYPES
Non esiste alcun tipo di supporto comune tra questi pin.
VFW_E_NOT_IN_GRAPH
Il filtro a cui appartiene questo pin non è nel grafico del filtro.

Commenti

Questo metodo esegue il rendering dei dati da un pin di output specificato, aggiungendo nuovi filtri al grafico in base alle esigenze. I filtri vengono provati nello stesso ordine del metodo IGraphBuilder::Connect . Per altre informazioni, vedere Intelligent Connect.

Durante il processo di connessione, Filter Graph Manager ignora i pin sui filtri intermedi se il nome del pin inizia con una tilde (~). Per altre informazioni, vedere PIN_INFO.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione strmif.h (include Dshow.h)
Libreria Strmiids.lib

Vedi anche

Codici errore e esito positivo

Interfaccia IGraphBuilder