Metodo IRenderEngine::SetFilterGraph
[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 SetFilterGraph metodo specifica un grafico di filtro da usare per il motore di rendering.
Sintassi
HRESULT SetFilterGraph(
IGraphBuilder *pFG
);
Parametri
-
Pfg
-
Puntatore all'interfaccia IGraphBuilder del grafico del filtro.
Valore restituito
Restituisce uno dei valori HRESULT seguenti:
| Codice restituito | Descrizione |
|---|---|
|
Operazione completata. |
|
Argomento non valido. |
|
Impossibile inizializzare il motore di rendering. |
Commenti
La maggior parte delle applicazioni non deve chiamare questo metodo. È più tipico consentire al motore di rendering di compilare automaticamente il grafico chiamando il metodo IRenderEngine::ConnectFrontEnd .
Questo metodo ha esito negativo se il motore di rendering dispone già di un grafico di filtro.
Non recuperare mai un puntatore a un grafico di filtro creato da un motore di rendering e quindi usarlo come parametro per questo metodo in un altro motore di rendering. In questo modo si verificheranno risultati imprevedibili.
Il metodo ConnectFrontEnd rimuove qualsiasi grafico di filtro esistente, ma mantiene la stessa istanza di Filter Graph Manager.
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