Metodo IRenderEngine::GetFilterGraph
[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.
Nota
[Deprecata. Questa API può essere rimossa dalle versioni future di Windows.]
Il GetFilterGraph metodo recupera il grafico del filtro costruito dal motore di rendering, se presente.
Sintassi
HRESULT GetFilterGraph(
[out] IGraphBuilder **ppFG
);
Parametri
-
ppFG [out]
-
Riceve un puntatore all'interfaccia IGraphBuilder del grafo del filtro. Riceve il valore NULL se non è presente alcun grafico di filtro.
Valore restituito
Restituisce uno dei valori HRESULT seguenti:
| Codice restituito | Descrizione |
|---|---|
|
Operazione completata. |
|
Impossibile inizializzare il motore di rendering. |
|
Puntatore non valido. |
Commenti
Usare il metodo IRenderEngine::ConnectFrontEnd per compilare il front-end del grafico del filtro. Per l'anteprima, usare IRenderEngine::RenderOutputPins per completare il grafico. Per l'output del file, connettere il front-end a una combinazione di mux/file writer. Per altre informazioni, vedere Rendering di un progetto.
Il grafico risultante può essere eseguito, sospeso, arrestato e cercato; non è tuttavia possibile modificare la frequenza di riproduzione.
In caso contrario, se il valore di *ppFG è diverso da NULL, l'interfaccia IGraphBuilder ha un conteggio dei riferimenti in sospeso. Assicurarsi di rilasciare l'interfaccia al termine dell'uso.
Nota
Il file di intestazione Qedit.h non è compatibile con le intestazioni Direct3D successive alla versione 7.
Nota
Per ottenere Qedit.h, scaricare l'aggiornamento Microsoft Windows SDK per Windows Vista e .NET Framework 3.0. Qedit.h non è disponibile nella Microsoft Windows SDK per Windows 7 e .NET Framework 3.5 Service Pack 1.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione |
|
| Libreria |
|
Vedi anche