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
S_OK	Operazione completata.
E_INVALIDARG	Argomento non valido.
E_MUST_INIT_RENDERER	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	Qedit.h
Libreria	Strmiids.lib

Vedi anche

Interfaccia IRenderEngine

Codici di errore e di esito positivo