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

Article
03/04/2024

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si 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 Render méthode termine le rendu du flux à l’origine de cette broche. Cela peut impliquer l’ajout de filtres au graphique de filtres et leur connexion.

Syntaxe

HRESULT Render(
  [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 filtres.

Valeur retournée

Retourne une valeur HRESULT . Un code de retour de S_OK indique que le flux a été correctement rendu.

Remarques

Le code suivant montre comment implémenter cette méthode sur une broche de sortie. Cet exemple suppose que le filtre nécessite un renderer personnalisé en aval.

C++

C++
STDMETHODIMP CMyOutputPin::Render(IPin pPin, IGraphBuilder pGraph) { CheckPointer(pPin, E_POINTER); CheckPointer(pGraph, E_POINTER); // This filter needs a special renderer connected to it. IBaseFilter pMyRenderer = NULL; // Create the renderer. HRESULT hr = CoCreateInstance(CLSID_MyRenderer, NULL, CLSCTX_INPROC, IID_IBaseFilter, (void )&pMyRenderer); if (FAILED(hr)) { return hr; } // Add my renderer to the filter graph. hr = pGraph->AddFilter(pMyRenderer, L"My Renderer"); if (FAILED(hr)) { pMyRenderer->Release(); return hr; } IEnumPins pEnumPins; IPin *pMyRendererInputPin = NULL; hr = pMyRenderer->EnumPins(&pEnumPins); if (SUCCEEDED(hr)) { if (S_OK != pEnumPins->Next(1, &pMyRendererInputPin, 0)) { hr = E_UNEXPECTED; } } if (SUCCEEDED(hr)) { // Connect my renderer to my output pin. hr = pGraph->ConnectDirect(pPin, pMyRendererInputPin); pMyRendererInputPin->Release(); } if (FAILED(hr)) { // Could not connect to my renderer. Remove it from the graph. pGraph->RemoveFilter(pMyRenderer); } pMyRenderer->Release(); return hr; }

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

    // This filter needs a special renderer connected to it.
    IBaseFilter *pMyRenderer = NULL;

    // Create the renderer.
    HRESULT hr = CoCreateInstance(CLSID_MyRenderer, NULL, CLSCTX_INPROC,
        IID_IBaseFilter, (void **)&pMyRenderer);
    if (FAILED(hr))
    {
        return hr;
    }
    
    // Add my renderer to the filter graph.
    hr = pGraph->AddFilter(pMyRenderer, L"My Renderer");
    if (FAILED(hr))
    {
        pMyRenderer->Release();
        return hr;
    }

    IEnumPins *pEnumPins;
    IPin *pMyRendererInputPin = NULL;
    hr = pMyRenderer->EnumPins(&pEnumPins);
    if (SUCCEEDED(hr)) 
    {
        if (S_OK != pEnumPins->Next(1, &pMyRendererInputPin, 0))
        {
            hr = E_UNEXPECTED;
         }
    }
    if (SUCCEEDED(hr)) 
    {
        // Connect my renderer to my output pin.
        hr = pGraph->ConnectDirect(pPin, pMyRendererInputPin);
        pMyRendererInputPin->Release();
    }
    if (FAILED(hr)) 
    {
        // Could not connect to my renderer. Remove it from the graph.
        pGraph->RemoveFilter(pMyRenderer);
    }
    pMyRenderer->Release();
    return hr;
}

Configuration requise

Condition requise	Valeur
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