IStreamBuilder::Backout-Methode (strmif.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die Backout -Methode hebt die in der IStreamBuilder::Render-Methode ausgeführten Schritte auf. Dies umfasst das Trennen und Entfernen aller Filter, die in Render hinzugefügt wurden.

Syntax

HRESULT Backout(
  [in] IPin          *ppinOut,
  [in] IGraphBuilder *pGraph
);

Parameter

[in] ppinOut

Zeiger auf die IPin-Schnittstelle dieses Pins.

[in] pGraph

Zeiger auf die IGraphBuilder-Schnittstelle des Filter Graph-Managers.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Ein Rückgabecode von S_OK gibt dem Graph-Generator an, dass die Trennung erfolgreich war.

Bemerkungen

Das folgende Beispiel zeigt, wie ein Filter die Schritte umkehren würde, die im Codebeispiel für die IStreamBuilder::Render-Methode gezeigt werden:

STDMETHODIMP CMyOutputPin::BackOut(IPin *pPin, IGraphBuilder *pGraph)
{
    CheckPointer(pPin, E_POINTER);
    CheckPointer(pGraph, E_POINTER);

    HRESULT hr = S_OK;
    if (m_Connected != NULL) // Pointer to the pin we're connected to.
    {
        // Find the filter that owns the pin connected to us.
        FILTER_INFO fi;
        hr = m_Connected->QueryFilterInfo(&fi);
        if (SUCCEEDED(hr)) 
        {
            if (fi.pFilter != NULL) 
            {
                //  Disconnect the pins.
                pGraph->Disconnect(m_Connected);
                pGraph->Disconnect(pPin);
                // Remove the filter from the graph.
                pGraph->RemoveFilter(fi.pFilter);
                fi.pFilter->Release();
            } 
            else 
            {
                hr = E_UNEXPECTED;
            }
        }
    }
    return hr;
}

Anforderungen

Siehe auch

Fehler- und Erfolgscodes

IStreamBuilder-Schnittstelle