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 |
|---|---|
|
Il gruppo non dispone di un pin di output. |
|
Operazione completata. |
|
Argomento non valido. |
|
Impossibile inizializzare il motore di rendering. |
|
Puntatore non valido. |
|
Operazione non riuscita perché il rendering del progetto non è riuscito. |
|
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 |
|
| Libreria |
|
Vedi anche