Metodo CBaseRenderer.GetSampleTimes

Articolo
07/28/2023

[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 GetSampleTimes metodo recupera i timestamp da un esempio.

Sintassi

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

Parametri

pMediaSample: Puntatore all'interfaccia IMediaSample dell'esempio.
pStartTime: Puntatore a una variabile che riceve l'ora di inizio.
pEndTime: Puntatore a una variabile che riceve l'ora di fine.

Valore restituito

Restituisce un valore HRESULT . I valori possibili includono quelli 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.
E_FAIL	Non eseguire il rendering di questo esempio.
VFW_E_START_TIME_AFTER_END	Timestamp non valido: l'ora di fine è precedente all'ora di inizio.

Commenti

Il filtro chiama questo metodo per determinare come gestire un esempio. Se il valore restituito è S_OK, il filtro esegue immediatamente il rendering dell'esempio. Se il valore restituito è S_FALSE, il filtro pianifica l'esempio per il rendering, in base ai timestamp. Se il valore restituito è un codice di errore, il filtro rifiuta l'esempio.

Questo metodo restituisce S_OK se l'esempio non ha timestamp o se il filtro non ha un orologio di riferimento. In caso contrario, restituisce il valore del metodo CBaseRenderer::ShouldDrawSampleNow . Nella classe di base , ShouldDrawSampleNow restituisce sempre S_FALSE. La classe derivata può eseguire l'override di questo comportamento. Ad esempio, se la classe derivata implementa la gestione del controllo qualità, potrebbe restituire E_FAIL per eliminare un esempio.

Requisiti

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

Vedi anche

Classe CBaseRenderer

Condividi tramite