Metodo IStreamBuilder::Render (strmif.h)

Articolo
03/13/2024

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine 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, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il Render metodo completa il rendering del flusso di origine con questo pin. Ciò può comportare l'aggiunta di filtri al grafico dei filtri e la loro connessione.

Sintassi

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

Parametri

[in] ppinOut

Puntatore all'interfaccia IPin di questo pin.

[in] pGraph

Puntatore all'interfaccia IGraphBuilder di Filter Graph Manager.

Valore restituito

Restituisce un valore HRESULT . Un codice restituito di S_OK indica che il rendering del flusso è stato eseguito correttamente.

Commenti

Il codice seguente illustra come implementare questo metodo in un pin di output. In questo esempio si presuppone che il filtro richieda un renderer personalizzato a valle.

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	strmif.h (include Dshow.h)
Libreria	Strmiids.lib

Vedi anche

Codici di errore e di esito positivo

Interfaccia IStreamBuilder

Condividi tramite