Metodo IRenderEngine::ConnectFrontEnd
[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 ConnectFrontEnd metodo compila il front-end del grafico del filtro dalla sequenza temporale corrente.
Sintassi
HRESULT ConnectFrontEnd();
Parametri
Questo metodo non presenta parametri.
Valore restituito
Restituisce un valore HRESULT . I valori restituiti possibili includono quanto segue:
| Codice restituito | Descrizione |
|---|---|
|
Operazione completata. |
|
La parte di rendering del grafico è stata eliminata. |
|
Nessuna sequenza temporale impostata per questo motore di rendering. |
|
Impossibile inizializzare il motore di rendering. |
|
Operazione non riuscita perché il rendering del progetto non è stato eseguito correttamente. |
|
Errore imprevisto. |
|
Tipo di supporto non valido. |
Commenti
Questo metodo non compila la parte di rendering del grafico del filtro. L'applicazione deve connettere i pin di output sul front-end ai filtri di rendering desiderati:
- Per visualizzare l'anteprima, chiamare il metodo IRenderEngine::RenderOutputPins .
- Per restituire un file, chiamare IRenderEngine::GetGroupOutputPin per recuperare il pin di output per ogni gruppo, quindi connettere i pin a un filtro multiplexer.
Se si usa il motore di rendering di base, i pin di output sul front-end producono dati non compressi. Se si usa il motore di rendering intelligente, i pin di output producono dati compressi.
Se si modifica la sequenza temporale dopo aver compilato il grafico del filtro, è necessario chiamare ConnectFrontEnd di nuovo per ricompilare il front-end. Il metodo mantiene la parte di rendering del grafico quando possibile. Tuttavia, se si aggiunge o si elimina un gruppo o si modifica l'ordine dei gruppi, ConnectFrontEnd elimina la parte di rendering e l'applicazione deve ricompilarla. Se il metodo elimina la parte di rendering, restituisce S_WARN_OUTPUTRESET.
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