Metodo IFilterGraph2::RenderEx (strmif.h)

Articolo
07/28/2023

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine 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, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il metodo esegue il RenderEx rendering di un pin di output, con un'opzione per usare solo i renderer esistenti.

Sintassi

HRESULT RenderEx(
  [in]      IPin  *pPinOut,
  [in]      DWORD dwFlags,
  [in, out] DWORD *pvContext
);

Parametri

[in] pPinOut

Puntatore all'interfaccia IPin del pin di output.

[in] dwFlags

Flag che specifica come eseguire il rendering del pin. Se il valore è AM_RENDEREX_RENDERTOEXISTINGRENDERERS, il metodo tenta di usare i renderer già nel grafico del filtro. Non aggiungerà nuovi renderer al grafico. Se necessario, aggiungerà filtri di trasformazione intermedi. Affinché il metodo abbia esito positivo, il grafico deve contenere i renderer appropriati e devono avere pin di input non connessi. Se il valore è zero, il metodo si comporta in modo identico al metodo IGraphBuilder::Render .

[in, out] pvContext

Riservato. Deve essere NULL.

Valore restituito

Restituisce un valore HRESULT.

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 di errore e di esito positivo

Interfaccia IFilterGraph2

Share via