Classe CSourceSeeking

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

gerarchia di classi csourceseeking

La classe CSourceSeeking è una classe astratta per implementare la ricerca nei filtri di origine con un pin di output.

Questa classe supporta l'interfaccia IMediaSeeking . Fornisce implementazioni predefinite per tutti i metodi IMediaSeeking . Le variabili membro protette archiviano l'ora di inizio, l'ora di arresto e la frequenza corrente. Per impostazione predefinita, l'unico formato ora supportato dalla classe è TIME_FORMAT_MEDIA_TIME (100-nanosecondi). Per ulteriori informazioni, vedere la sezione Osservazioni.

Variabili membro protette Descrizione
m_rtDuration Durata del flusso.
m_rtStart Ora di inizio.
m_rtStop Arrestare il tempo.
m_dRateSeeking Frequenza di riproduzione.
m_dwSeekingCaps Ricerca di funzionalità.
m_pLock Puntatore a un oggetto sezione critica per il blocco.
Metodi protetti Descrizione
CSourceSeeking Metodo costruttore.
Metodi virtuali pure Descrizione
ChangeRate Chiamato quando cambia la frequenza di riproduzione.
ChangeStart Chiamato quando cambia la posizione iniziale.
ChangeStop Chiamato quando cambia la posizione di arresto.
Metodi IMediaSeeking Descrizione
IsFormatSupported Determina se è supportato un formato di tempo specificato.
QueryPreferredFormat Recupera il formato di tempo preferito dell'oggetto.
SetTimeFormat Imposta il formato ora.
IsUsingTimeFormat Determina se un formato ora specificato è il formato attualmente in uso.
GetTimeFormat Recupera il formato ora corrente.
GetDuration Recupera la durata del flusso.
GetStopPosition Recupera il tempo in cui la riproduzione si arresterà, rispetto alla durata del flusso.
GetCurrentPosition Recupera la posizione corrente, rispetto alla durata totale del flusso.
GetCapabilities Recupera tutte le funzionalità di ricerca del flusso.
CheckCapabilities Esegue query sul fatto che il flusso abbia specificato le funzionalità di ricerca.
ConvertTimeFormat Converte da un formato all'altro.
SetPositions Imposta la posizione corrente e la posizione di arresto.
GetPositions Recupera la posizione corrente e la posizione di arresto.
GetAvailable Recupera l'intervallo di volte in cui la ricerca è efficiente.
SetRate Imposta la frequenza di riproduzione.
GetRate Recupera la frequenza di riproduzione.
GetPreroll Recupera l'ora di preroll.

Commenti

Ogni volta che la posizione iniziale, la posizione di arresto o la frequenza di riproduzione cambia, l'oggetto CSourceSeeking chiama un metodo virtuale puro corrispondente:

La classe derivata deve implementare questi metodi. Dopo qualsiasi operazione di ricerca, un filtro deve eseguire le operazioni seguenti:

  1. Chiamare il metodo IPin::BeginFlush nel pin di input downstream.
  2. Arrestare il thread di lavoro che fornisce i dati.
  3. Chiamare il metodo IPin::EndFlush nel pin di input.
  4. Riavviare il thread di lavoro.
  5. Chiamare il metodo IPin::NewSegment nel pin di input.
  6. Impostare la proprietà di discontinuità nel primo esempio. Chiamare il metodo IMediaSample::SetDiscontinuity .

La chiamata a BeginFlush libera il thread di lavoro, se il thread è bloccato in attesa di consegnare un esempio.

Nel passaggio 2 assicurarsi che il thread abbia interrotto l'invio di dati. A seconda dell'implementazione, potrebbe essere necessario attendere che il thread venga chiuso o che il thread segnali una risposta di qualche tipo. Se il filtro usa la classe CSourceStream , il metodo CSourceStream::Stop blocca fino a quando il thread di lavoro risponde.

Idealmente, il nuovo segmento (passaggio 5) deve essere recapitato dal thread di lavoro. Può anche essere eseguita dall'oggetto CSourceSeeking , purché il filtro lo serializzi con gli esempi.

Nell'esempio seguente viene illustrata una possibile implementazione. Si presuppone che il pin di output del filtro di origine sia derivato da CSourceSeeking e CSourceStream. In questo esempio viene definito un metodo helper, UpdateFromSeek, che esegue i passaggi 1 4. Il metodo CSourceStream::OnThreadStartPlay viene sottoposto a override per inviare il nuovo segmento e per impostare un flag che indica la discontinuità. Il thread di lavoro seleziona questo flag e chiama il metodo IMediaSample::SetDiscontinuity :

void CMyStream::UpdateFromSeek()
{
    if (ThreadExists()) 
    {
        DeliverBeginFlush();
        Stop();
        DeliverEndFlush();
        Run();
    }
}

HRESULT CMyStream::OnThreadStartPlay()
{
    m_bDiscontinuity = TRUE;
    return DeliverNewSegment(m_rtStart, m_rtStop, m_dRateSeeking);
}

Supporto di formati di tempo aggiuntivi

Per impostazione predefinita, questa classe supporta la ricerca solo in unità di tempo di riferimento (TIME_FORMAT_MEDIA_TIME). Per supportare formati di tempo aggiuntivi, eseguire l'override dei metodi IMediaSeeking che gestiscono i formati temporali:

Inoltre, eseguire l'override dei metodi IMediaSeeking rimanenti per eseguire le conversioni necessarie tra formati di tempo. Dopo aver chiamato il metodo SetTimeFormat , tutti i metodi IMediaSeeking devono considerare i parametri di ora in ingresso e in uscita come nel nuovo formato temporale. Ad esempio, se la variabile m_rtDuration rappresenta la durata in unità di tempo di riferimento, ma il formato ora corrente è frame, il metodo GetDuration deve restituire il valore m_rtDuration convertito in frame. Ad esempio:

STDMETHODIMP GetDuration(LONGLONG *pDuration)
{
    HRESULT hr = CSourceSeeking::GetDuration(pDuration);
    if (SUCCEEDED(hr))
    {
        if (m_TimeFormat == TIME_FORMAT_FRAME)
        {
            // Convert from reference time to frames.
            *pDuration = TimeToFrame(*pDuration);  // Private method.
        }
    }
    return hr
}

Assicurarsi inoltre di verificare la presenza del flag AM_SEEKING_ReturnTime nel metodo IMediaSeeking::SetPositions . Se questo flag è presente, convertire i valori di posizione in momenti di riferimento quando vengono restituiti al chiamante.

Requisiti

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

Vedi anche

Supporto per la ricerca in un filtro di origine