Шаг 4. Добавление отрисовщика видео

Статья
06/21/2023

[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код использовал MediaPlayer, IMFMediaEngine и аудио- и видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]

Этот раздел является шагом 4 руководства Воспроизведение звука и видео в DirectShow. Полный код показан в разделе Пример воспроизведения DirectShow.

DirectShow предоставляет несколько различных фильтров, которые отрисовывает видео:

Дополнительные сведения о различиях между этими фильтрами см. в разделе Выбор правильного отрисовщика видео.

В этом руководстве каждый фильтр отрисовщика видео упакован в класс, который абстрагирует некоторые различия между ними. Все эти классы являются производными от абстрактного базового класса с именем CVideoRenderer. Объявление CVideoRenderer отображается в разделе Шаг 2. Объявление CVideoRenderer и производных классов.

Следующий метод пытается создать каждый отрисовщик видео по очереди, начиная с EVR, затем VMR-9 и, наконец, VMR-7.

HRESULT DShowPlayer::CreateVideoRenderer()
{
    HRESULT hr = E_FAIL;

    enum { Try_EVR, Try_VMR9, Try_VMR7 };

    for (DWORD i = Try_EVR; i <= Try_VMR7; i++)
    {
        switch (i)
        {
        case Try_EVR:
            m_pVideo = new (std::nothrow) CEVR();
            break;

        case Try_VMR9:
            m_pVideo = new (std::nothrow) CVMR9();
            break;

        case Try_VMR7:
            m_pVideo = new (std::nothrow) CVMR7();
            break;
        }

        if (m_pVideo == NULL)
        {
            hr = E_OUTOFMEMORY;
            break;
        }

        hr = m_pVideo->AddToGraph(m_pGraph, m_hwnd);
        if (SUCCEEDED(hr))
        {
            break;
        }

        delete m_pVideo;
        m_pVideo = NULL;
    }
    return hr;
}

Фильтр EVR

Следующий код создает фильтр EVR и добавляет его в граф фильтра. Функция AddFilterByCLSID , используемая в этом примере, показана в разделе Добавление фильтра по CLSID.

HRESULT CEVR::AddToGraph(IGraphBuilder *pGraph, HWND hwnd)
{
    IBaseFilter *pEVR = NULL;

    HRESULT hr = AddFilterByCLSID(pGraph, CLSID_EnhancedVideoRenderer, 
        &pEVR, L"EVR");

    if (FAILED(hr))
    {
        goto done;
    }

    hr = InitializeEVR(pEVR, hwnd, &m_pVideoDisplay);
    if (FAILED(hr))
    {
        goto done;
    }

    // Note: Because IMFVideoDisplayControl is a service interface,
    // you cannot QI the pointer to get back the IBaseFilter pointer.
    // Therefore, we need to cache the IBaseFilter pointer.

    m_pEVR = pEVR;
    m_pEVR->AddRef();

done:
    SafeRelease(&pEVR);
    return hr;
}

Функция InitializeEVR инициализирует фильтр EVR. Эта функция выполняет следующие действия.

Запрашивает фильтр для интерфейса IMFGetService .
Вызывает IMFGetService::GetService , чтобы получить указатель на интерфейс IMFVideoDisplayControl .
Вызывает IMFVideoDisplayControl::SetVideoWindow , чтобы задать окно видео.
Вызывает метод IMFVideoDisplayControl::SetAspectRatioMode , чтобы настроить EVR для сохранения пропорций видео.

В следующем коде показана InitializeEVR функция .

HRESULT InitializeEVR( 
    IBaseFilter *pEVR,              // Pointer to the EVR
    HWND hwnd,                      // Clipping window
    IMFVideoDisplayControl** ppDisplayControl
    ) 
{ 
    IMFGetService *pGS = NULL;
    IMFVideoDisplayControl *pDisplay = NULL;

    HRESULT hr = pEVR->QueryInterface(IID_PPV_ARGS(&pGS)); 
    if (FAILED(hr))
    {
        goto done;
    }

    hr = pGS->GetService(MR_VIDEO_RENDER_SERVICE, IID_PPV_ARGS(&pDisplay));
    if (FAILED(hr))
    {
        goto done;
    }

    // Set the clipping window.
    hr = pDisplay->SetVideoWindow(hwnd);
    if (FAILED(hr))
    {
        goto done;
    }

    // Preserve aspect ratio by letter-boxing
    hr = pDisplay->SetAspectRatioMode(MFVideoARMode_PreservePicture);
    if (FAILED(hr))
    {
        goto done;
    }

    // Return the IMFVideoDisplayControl pointer to the caller.
    *ppDisplayControl = pDisplay;
    (*ppDisplayControl)->AddRef();

done:
    SafeRelease(&pGS);
    SafeRelease(&pDisplay);
    return hr; 
}

После построения графа DShowPlayer::RenderStreams вызывает .CVideoRenderer::FinalizeGraph Этот метод выполняет любую окончательную инициализацию или очистку. В следующем коде показана CEVR реализация этого метода.

HRESULT CEVR::FinalizeGraph(IGraphBuilder *pGraph)
{
    if (m_pEVR == NULL)
    {
        return S_OK;
    }

    BOOL bRemoved;
    HRESULT hr = RemoveUnconnectedRenderer(pGraph, m_pEVR, &bRemoved);
    if (bRemoved)
    {
        SafeRelease(&m_pEVR);
        SafeRelease(&m_pVideoDisplay);
    }
    return hr;
}

Если EVR не подключен к другому фильтру, этот метод удаляет EVR из графа. Это может произойти, если файл мультимедиа не содержит видеопотока.

Фильтр VMR-9

Следующий код создает фильтр VMR-9 и добавляет его в граф фильтра.

HRESULT CVMR9::AddToGraph(IGraphBuilder *pGraph, HWND hwnd)
{
    IBaseFilter *pVMR = NULL;

    HRESULT hr = AddFilterByCLSID(pGraph, CLSID_VideoMixingRenderer9, 
        &pVMR, L"VMR-9");
    if (SUCCEEDED(hr))
    {
        // Set windowless mode on the VMR. This must be done before the VMR 
        // is connected.
        hr = InitWindowlessVMR9(pVMR, hwnd, &m_pWindowless);
    }
    SafeRelease(&pVMR);
    return hr;
}

Функция InitWindowlessVMR9 инициализирует VMR-9 для режима без окон. (Дополнительные сведения о режиме без окон см. в разделе VMR Windowless Mode.) Эта функция выполняет следующие действия.

Запрашивает фильтр VMR-9 для интерфейса IVMRFilterConfig9 .
Вызывает метод IVMRFilterConfig9::SetRenderingMode , чтобы задать режим без окна.
Запрашивает фильтр VMR-9 для интерфейса IVMRWindowlessControl9 .
Вызывает метод IVMRWindowlessControl9::SetVideoClippingWindow , чтобы задать окно видео.
Вызывает метод IVMRWindowlessControl9::SetAspectRatioMode для сохранения пропорций видео.

В следующем коде показана InitWindowlessVMR9 функция .

HRESULT InitWindowlessVMR9( 
    IBaseFilter *pVMR,              // Pointer to the VMR
    HWND hwnd,                      // Clipping window
    IVMRWindowlessControl9** ppWC   // Receives a pointer to the VMR.
    ) 
{ 

    IVMRFilterConfig9 * pConfig = NULL; 
    IVMRWindowlessControl9 *pWC = NULL;

    // Set the rendering mode.  
    HRESULT hr = pVMR->QueryInterface(IID_PPV_ARGS(&pConfig)); 
    if (FAILED(hr))
    {
        goto done;
    }

    hr = pConfig->SetRenderingMode(VMR9Mode_Windowless); 
    if (FAILED(hr))
    {
        goto done;
    }

    // Query for the windowless control interface.
    hr = pVMR->QueryInterface(IID_PPV_ARGS(&pWC));
    if (FAILED(hr))
    {
        goto done;
    }

    // Set the clipping window.
    hr = pWC->SetVideoClippingWindow(hwnd);
    if (FAILED(hr))
    {
        goto done;
    }

    // Preserve aspect ratio by letter-boxing
    hr = pWC->SetAspectRatioMode(VMR9ARMode_LetterBox);
    if (FAILED(hr))
    {
        goto done;
    }

    // Return the IVMRWindowlessControl pointer to the caller.
    *ppWC = pWC;
    (*ppWC)->AddRef();

done:
    SafeRelease(&pConfig);
    SafeRelease(&pWC);
    return hr; 
}

Метод CVMR9::FinalizeGraph проверяет, подключен ли фильтр VMR-9, и, если нет, удаляет его из графа фильтра.

HRESULT CVMR9::FinalizeGraph(IGraphBuilder *pGraph)
{
    if (m_pWindowless == NULL)
    {
        return S_OK;
    }

    IBaseFilter *pFilter = NULL;

    HRESULT hr = m_pWindowless->QueryInterface(IID_PPV_ARGS(&pFilter));
    if (FAILED(hr))
    {
        goto done;
    }

    BOOL bRemoved;
    hr = RemoveUnconnectedRenderer(pGraph, pFilter, &bRemoved);

    // If we removed the VMR, then we also need to release our 
    // pointer to the VMR's windowless control interface.
    if (bRemoved)
    {
        SafeRelease(&m_pWindowless);
    }

done:
    SafeRelease(&pFilter);
    return hr;
}

Фильтр VMR-7

Действия для фильтра VMR-7 практически идентичны действиям для VMR-9, за исключением интерфейсов VMR-7. Следующий код создает фильтр VMR-7 и добавляет его в граф фильтра.

HRESULT CVMR7::AddToGraph(IGraphBuilder *pGraph, HWND hwnd)
{
    IBaseFilter *pVMR = NULL;

    HRESULT hr = AddFilterByCLSID(pGraph, CLSID_VideoMixingRenderer, 
        &pVMR, L"VMR-7");

    if (SUCCEEDED(hr))
    {
        // Set windowless mode on the VMR. This must be done before the VMR
        // is connected.
        hr = InitWindowlessVMR(pVMR, hwnd, &m_pWindowless);
    }
    SafeRelease(&pVMR);
    return hr;
}

Функция InitWindowlessVMR инициализирует VMR-7 для режима без окон. Эта функция выполняет следующие действия.

Запрашивает фильтр VMR-7 для интерфейса IVMRFilterConfig .
Вызывает метод IVMRFilterConfig::SetRenderingMode для установки режима без окон.
Запрашивает фильтр VMR-7 для интерфейса IVMRWindowlessControl .
Вызывает метод IVMRWindowlessControl::SetVideoClippingWindow , чтобы задать окно видео.
Вызывает метод IVMRWindowlessControl::SetAspectRatioMode для сохранения пропорций видео.

В следующем коде показана InitWindowlessVMR функция .

HRESULT InitWindowlessVMR( 
    IBaseFilter *pVMR,              // Pointer to the VMR
    HWND hwnd,                      // Clipping window
    IVMRWindowlessControl** ppWC    // Receives a pointer to the VMR.
    ) 
{ 

    IVMRFilterConfig* pConfig = NULL; 
    IVMRWindowlessControl *pWC = NULL;

    // Set the rendering mode.  
    HRESULT hr = pVMR->QueryInterface(IID_PPV_ARGS(&pConfig)); 
    if (FAILED(hr))
    {
        goto done;
    }

    hr = pConfig->SetRenderingMode(VMRMode_Windowless); 
    if (FAILED(hr))
    {
        goto done;
    }

    // Query for the windowless control interface.
    hr = pVMR->QueryInterface(IID_PPV_ARGS(&pWC));
    if (FAILED(hr))
    {
        goto done;
    }

    // Set the clipping window.
    hr = pWC->SetVideoClippingWindow(hwnd);
    if (FAILED(hr))
    {
        goto done;
    }

    // Preserve aspect ratio by letter-boxing
    hr = pWC->SetAspectRatioMode(VMR_ARMODE_LETTER_BOX);
    if (FAILED(hr))
    {
        goto done;
    }

    // Return the IVMRWindowlessControl pointer to the caller.
    *ppWC = pWC;
    (*ppWC)->AddRef();

done:
    SafeRelease(&pConfig);
    SafeRelease(&pWC);
    return hr; 
}

Метод CVMR7::FinalizeGraph проверяет, подключен ли фильтр VMR-7, и, если нет, удаляет его из графа фильтра.

HRESULT CVMR7::FinalizeGraph(IGraphBuilder *pGraph)
{
    if (m_pWindowless == NULL)
    {
        return S_OK;
    }

    IBaseFilter *pFilter = NULL;

    HRESULT hr = m_pWindowless->QueryInterface(IID_PPV_ARGS(&pFilter));
    if (FAILED(hr))
    {
        goto done;
    }

    BOOL bRemoved;
    hr = RemoveUnconnectedRenderer(pGraph, pFilter, &bRemoved);

    // If we removed the VMR, then we also need to release our 
    // pointer to the VMR's windowless control interface.
    if (bRemoved)
    {
        SafeRelease(&m_pWindowless);
    }

done:
    SafeRelease(&pFilter);
    return hr;
}

Пример воспроизведения DirectShow
Использование фильтра DirectShow EVR
Использование отрисовщика смешанного видео

Поделиться через

Шаг 4. Добавление отрисовщика видео

Фильтр EVR

Фильтр VMR-9

Фильтр VMR-7

Обратная связь

Дополнительные ресурсы

Поделиться через

Шаг 4. Добавление отрисовщика видео

Фильтр EVR

Фильтр VMR-9

Фильтр VMR-7

Связанные темы

Обратная связь

Дополнительные ресурсы