Classe CBaseRenderer

[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.

La CBaseRenderer classe è una classe base per l'implementazione dei filtri del renderer. Supporta un pin di input, implementato dalla classe CRendererInputPin . Per usare questa classe, dichiarare una classe derivata che eredita CBaseRenderer. Come minimo, la classe derivata deve implementare i metodi seguenti, dichiarati come virtuali pure nella classe base:

• CBaseRenderer::CheckMediaType: accetta o rifiuta i tipi di supporti proposti. Il filtro chiama questo metodo durante il processo di connessione pin.
• CBaseRenderer::D oRenderSample: esegue il rendering di un esempio. Il filtro chiama questo metodo per ogni campione ricevuto durante l'esecuzione.

La classe base gestisce le modifiche dello stato e i problemi di sincronizzazione. Pianifica anche i campioni per il rendering, anche se non implementa misure di controllo qualità. La classe base dichiara anche diversi metodi "gestore". Si tratta di metodi che il filtro chiama in punti specifici del processo di streaming. Non eseguono alcuna operazione nella classe base, ma la classe derivata può eseguirne l'override. Nella tabella seguente sono elencati sotto l'intestazione Metodi pubblici: Gestori.

Il gestore CBaseRenderer::OnReceiveFirstSample merita una menzione speciale. Il filtro chiama questo metodo se riceve un esempio mentre il filtro viene sospeso. Ciò può verificarsi se il grafico passa da arrestato a sospeso o se il grafico viene cercato durante la sospensione. I renderer video usano in genere l'esempio per visualizzare un fotogramma ancora. Quando il filtro passa dalla sospensione all'esecuzione, invia lo stesso esempio al metodo CBaseRenderer::D oRenderSample , come primo esempio del flusso.

La CBaseRenderer classe espone le interfacce IMediaSeeking e IMediaPosition tramite l'oggetto CRendererPosPassThru . Passa tutte le richieste di ricerca al successivo filtro upstream.

Pianificazione

Quando il filtro upstream chiama il metodo IMemInputPin::Receive del pin di input per recapitare un esempio, il pin passa questa chiamata al metodo CBaseRenderer::Receive del filtro. Il filtro elimina l'esempio, lo esegue immediatamente o lo pianifica per il rendering.

Se l'esempio non dispone di timestamp o se non è disponibile alcun orologio di riferimento, il filtro esegue immediatamente il rendering dell'esempio. In caso contrario, il filtro chiama il metodo CBaseRenderer::ShouldDrawSampleNow per determinare cosa fare. Per impostazione predefinita, l'esempio viene pianificato in base ai timestamp. La classe derivata può eseguire l'override di ShouldDrawSampleNow per supportare il controllo qualità.

Per pianificare un esempio, il filtro chiama il metodo IReferenceClock::AdviseTime , che crea una richiesta di avviso. Il metodo Receive viene quindi bloccato fino all'ora pianificata o fino a quando il filtro non cambia lo stato. Il blocco impedisce al filtro upstream di distribuire altri esempi fino a quando non viene eseguito il rendering dell'esempio corrente.

Quando il filtro upstream chiama il metodo IPin::EndOfStream per segnalare la fine del flusso, il filtro invia un evento EC_COMPLETE al gestore del grafo del filtro. Il filtro attende l'ora di arresto dell'esempio corrente prima di inviare l'evento.

Requisiti