Metodo IRenderEngine::GetGroupOutputPin

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine 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, FMMediaEngine e Audio/Video Capture in Media Foundation anziché 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 GetGroupOutputPin metodo recupera il pin di output per il gruppo specificato.

Sintassi

HRESULT GetGroupOutputPin(
        long Group,
  [out] IPin **ppRenderPin
);

Parametri

Gruppo

Indice in base zero che specifica il gruppo.

ppRenderPin [out]

Riceve un puntatore all'interfaccia IPin del pin di output.

Valore restituito

Restituisce un valore HRESULT . I possibili valori sono i seguenti:

Codice restituito	Descrizione
S_FALSE	Il gruppo non dispone di un pin di output.
S_OK	Operazione completata.
E_INVALIDARG	Argomento non valido.
E_MUST_INIT_RENDERER	Impossibile inizializzare il motore di rendering.
E_POINTER	Puntatore non valido.
E_RENDER_ENGINE_IS_BROKEN	Operazione non riuscita perché il rendering del progetto non è riuscito.
E_UNEXPECTED	Errore imprevisto.

 

Commenti

Prima di chiamare questo metodo, chiamare IRenderEngine::ConnectFrontEnd per compilare il front-end del grafico. Ogni gruppo rappresenta un singolo flusso multimediale e il front-end ha un pin di output corrispondente.

È possibile usare questo metodo per creare la parte di rendering di un grafico di scrittura file. Connettere i pin di output ai filtri multiplexer e ai filtri del writer di file. Per altre informazioni, vedere Rendering di un progetto.

Per l'anteprima non è necessario chiamare questo metodo. Chiamare ConnectFrontEnd seguito da IRenderEngine::RenderOutputPins.

Se il metodo restituisce S_OK, l'interfaccia IPin restituita ha un numero di riferimenti in sospeso. Assicurarsi di rilasciare l'interfaccia al termine dell'uso.

Nota

Il file di intestazione Qedit.h non è compatibile con 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 errore e esito positivo