Classe CPosPassThru

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

La CPosPassThru classe gestisce i comandi per i filtri di trasformazione passandoli a monte al filtro successivo.

Quando un'applicazione cerca il grafico del filtro, Filter Graph Manager fornisce il comando di ricerca ai filtri del renderer. Il comando viene passato a monte, tramite il pin di output di ogni filtro, fino a raggiungere un filtro che può eseguire il comando (se presente). Per informazioni dettagliate, vedere Ricerca. La CPosPassThru classe passa tutti i comandi di ricerca al pin di output nel filtro upstream, come illustrato nel diagramma seguente.

Anche se questa classe viene fornita nella libreria di classi di base, DirectShow fornisce anche la stessa classe in Quartz.dll. L'uso della versione Quartz.dll può ridurre le dimensioni del codice nel filtro in qualche modo, perché la classe viene caricata in fase di esecuzione dalla DLL. Per usare tale versione, chiamare la funzione CreatePosPassThru .

Nel metodo NonDelegatingQueryInterface del pin di output delegare all'oggetto CPosPassThru ogni volta che l'interfaccia richiesta è IMediaSeeking o IMediaPosition, come illustrato nel codice seguente:

// The following member variables are assumed:
IPin *m_pInput;    // Pointer to the input pin on your filter.
IUnknown *m_pPos;  // Pointer to the CPosPassThru object.

STDMETHODIMP CMyPin::NonDelegatingQueryInterface(REFIID riid, void **ppv)
{
    HRESULT hr
    if (riid == IID_IMediaPosition || riid == IID_IMediaSeeking) 
    {
        if (m_pPos == NULL) 
        {
            // We have not created the CPosPassThru object yet. Do so now.
            hr = CreatePosPassThru(GetOwner(), FALSE, m_pInput, &m_pPos);
            if (FAILED(hr)) return hr;
        }
        return m_pPos->QueryInterface(riid, ppv);
    } 
    else
    {
         // Other interfaces (not shown).
    }
}

~CMyPin::CMyPin() 
{
    // Release the CPosPassThruObject.
    if (m_pPos != NULL) m_pPos->Release();
}

Tranne dove indicato, tutti i metodi IMediaPosition e IMediaSeeking in questa classe chiamano il metodo corrispondente sul pin connesso e restituiscono il risultato.

Requisiti