Méthode IStreamBuilder::Backout (strmif.h)

Article
07/28/2023

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La Backout méthode annule les étapes effectuées dans la méthode IStreamBuilder::Render . Cela inclut la déconnexion et la suppression de tous les filtres qui ont été ajoutés dans Render.

Syntaxe

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

Paramètres

[in] ppinOut

Pointeur vers l’interface IPin de cette broche.

[in] pGraph

Pointeur vers l’interface IGraphBuilder du Gestionnaire de graphes de filtre.

Valeur renvoyée

Retourne une valeur HRESULT . Un code de retour de S_OK indique au générateur de graphiques que la déconnexion a réussi.

Notes

L’exemple suivant montre comment un filtre inverserait les étapes indiquées dans l’exemple de code de la méthode IStreamBuilder::Render :

C++

C++
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; }

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-&gt;QueryFilterInfo(&amp;fi);
        if (SUCCEEDED(hr)) 
        {
            if (fi.pFilter != NULL) 
            {
                //  Disconnect the pins.
                pGraph-&gt;Disconnect(m_Connected);
                pGraph-&gt;Disconnect(pPin);
                // Remove the filter from the graph.
                pGraph-&gt;RemoveFilter(fi.pFilter);
                fi.pFilter-&gt;Release();
            } 
            else 
            {
                hr = E_UNEXPECTED;
            }
        }
    }
    return hr;
}

Configuration requise


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	strmif.h (include Dshow.h)
Bibliothèque	Strmiids.lib

Voir aussi

Codes d’erreur et de réussite

IStreamBuilder Interface

Partager via