Metodo CBaseRenderer.ShouldDrawSampleNow

  • Articolo

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

Il ShouldDrawSampleNow metodo determina la modalità di pianificazione di un esempio per il rendering.

Sintassi

virtual HRESULT ShouldDrawSampleNow(
   IMediaSample   *pMediaSample,
   REFERENCE_TIME *pStartTime,
   REFERENCE_TIME *pEndTime
);

Parametri

pMediaSample

Puntatore all'interfaccia IMediaSample dell'esempio.

pStartTime

Puntatore a una variabile contenente l'ora di inizio dell'esempio.

pEndTime

Puntatore a una variabile contenente l'ora di fine dell'esempio.

Valore restituito

Restituisce S_FALSE. Se la classe derivata esegue l'override di questo metodo, restituire uno dei valori visualizzati nella tabella seguente.

Codice restituito Descrizione
S_OK
 L'esempio deve essere eseguito immediatamente.
S_FALSE
 L'esempio deve essere pianificato per il rendering, in base ai timestamp.
Codice di errore
 Non eseguire il rendering di questo esempio.

Commenti

Il metodo CBaseRenderer::GetSampleTimes chiama questo metodo. Per impostazione predefinita, gli esempi vengono sempre pianificati per il rendering in base ai relativi timestamp. La classe derivata può eseguire l'override di questo metodo; ad esempio, per implementare il controllo qualità.

Requisiti

Requisito Valore
Intestazione
Renbase.h (includere Streams.h)
Libreria
Strmbase.lib (build al dettaglio);
Strmbasd.lib (build di debug)

Vedi anche

Classe CBaseRenderer