DirectShow下的视频显示窗体

显示视频

DirectShow 提供了如下过滤器来显示视频：

• Video Renderer 过滤器. 该过滤器可用于所有的支持DirectX的平台，它对平台没有其它特殊的要求。可以是它，或GDI来显示视频。
• Video Mixing Renderer Filter 7 (VMR-7). VMR-7可用于WindowsXP操作系统，并且是该系统下的默认视频显示过滤器。与老的视频显示过滤器相比，它具有一些更强大的性能，包括采用插件模式来控制DirectShow显示。
• Video Mixing Renderer Filter 9 (VMR-9). VMR-9是一个更新的视频混合显示过滤器，它采用了Direct3D来显示。它可用于所有的支持DirectX的平台。它不是默认的显示过滤器，因为它与其它的显示过滤器相比，对系统要求更高。

     一般来说，在视频显示应用上，VMR-9是首选。因为，它使用了最新的图像API，并且提供了最好的性能。

窗体模式和非窗体模式 DirectShow视频显示可以选择在窗体模式或者非窗体模式下进行。

• 在窗体模式下，视频将创建一个它自己的窗体来显示。
• 在非窗体模式下，视频可以自己在你程序的一个窗口上显示，而不让视频自己区创建窗体来显示.

Video Renderer过滤器只支持窗体模式，VMR-7和VMR-9支持这两种模式。它们默认状态是窗体模式。

设置视频窗口

     在窗体模式下，视频将创建一个窗口，然后在该窗口上显示视频。大多数情况下，你可能想要把该窗口绑定到你的应用程序中。通过使用IVideoWindow接口，可以设置视频窗口的类型和位置。
     在开始播放前，在过滤器图表管理器中去查找IVideoWindow接口：

IVideoWindow *pVidWin = NULL;
pGraph->QueryInterface(IID_IVideoWindow, (void **)&g_pVidWin);

     调用IVideoWindow::put_Owner方法去处理你应用程序的窗体。该方法提供了一个OAHWND类型的变量，所以要把句柄转换为该类型：

pVidWin->put_Owner((OAHWND)hwnd);

     调用IVideoWindow::Put_WindowStyle来改变视频窗体的类型：

pVidWin->put_WindowStyle(WS_CHILD | WS_CLIPSIBLINGS);

    WS_CHILD标志设置视频窗体为一个子窗体，WS_CLIPSIBLINGS标志可以防止视频窗体在另一个子窗体的客户区内显示视频。
     调用IVideoWindow::SetWindowPosition方法可以视频窗口的相对于你应用程序的客户区的位置。该方法的参数带了一个RECT参数，用它去指定视频窗口的位置。下例，让视频窗口和它父窗体的客户区想匹配。

RECT grc;
GetClientRect(hwnd, &grc);
pVidWin->SetWindowPosition(0, 0, grc.right, grc.bottom);

     通过在过滤器图表管理器上调用IBaseicVideo::GetVideoSize方法可以得到视频本身的尺寸大小。你可以通过这些信息让视频保持正确的纵横比例。
     在应用程序退出前，停止图表并重置视频窗口为NULL。否则，窗口消息可能被错误的发送给错误的窗口，从而导致错误发生，

pControl->Stop();
pVidWin->put_Visible(OAFALSE);
pVidWin->put_Owner(NULL);

使用非窗体模式

     视频混合显示过滤器（VMR-7和 VMR-9）都支持非窗体模式。这里将描述窗体模式和非窗体模式之间的不同，以及如何使用非模式窗体。
     为了向后兼容已经在使用的应用程序，VMR默认的显示模式为窗体模式。在窗体模式中，视频创建一个它自己的窗体去显示视频。应用程序设置这个视频窗体为它 的一个子窗体。这个单独存在的窗体会导致如下问题： 最严重的是，如果窗体的消息在线程间发送可能导致消息死锁。

• 过滤器图表管理器必须传递某些window消息，比如WM_PAINT，给视频显示器(Video Renderer)。这些对IVideoWIndow的操作必须是由过滤器图表管理器来完成，而不是视频显示器来完成，所以要靠过滤器图表管理器来纠正内部状态。
• 要视频窗体的鼠标或者键盘事件，应用程序必须建立一个“消息通道”，让视频窗口把消息传递给应用程序。
• 为了防止剪接的情况，视频窗体还必须拥有正确的窗口状态。

     非窗体模式通过使用VMR直接在应用程序的客户区上画图来避免了上述的问题。它使用DirectDraw去剪接视频矩形。非窗体模式极大程度减少了死锁的 偶然发生。同样，应用程序不必去设置视频自身创建的窗口和窗口的状态。事实上，当VRM使用窗体模式时，它也不使用IVideoWindow接口。
     要使用非窗体模式，你必须明确地去配置VMR。你会发现配置工作非常灵活并且比窗体模式更容易。
     在配置VMR 前应建立过滤器图表(Filter graph):

1. 创建过滤器图表管理器（Filter Graph Manager）。
2. 创建VMR并添加到过滤器图表中（filter graph）。
3. 在VMR中调用IVMRFilterConfig::SetRenderingMode 设置VMRMode_Windowless 标识。
4. 在VMR中调用 IVMRWindowlessControl::SetVideoClippingWindow 去指定视频将要显示的窗体句柄

。
     现在调用IGraphBuilder::RenderFile完成过滤器图表余下的工作。过滤器图表管理器将自动使用这个你添加到过滤器图表中的VMR实例。
     下面代码显示了这些工作：

HRESULT InitWindowlessVMR( 
    HWND hwndApp,                   // 视频窗体 
    IGraphBuilder* pGraph,           // 过滤器图表指针 
    IVMRWindowlessControl** ppWc,  // 接收VMR指针
    ) 
{ 
    if (!pGraph || !ppWc) return E_POINTER;
    IBaseFilter* pVmr = NULL; 
    IVMRWindowlessControl* pWc = NULL; 
        
    // 创建VMR 
    HRESULT hr = CoCreateInstance(CLSID_VideoMixingRenderer, NULL, 
        CLSCTX_INPROC, IID_IBaseFilter, (void**)&pVmr); 
    if (FAILED(hr))
    {
        return hr;
    }    

    // 把VMR添加到过滤器图表中
    hr = pGraph->AddFilter(pVmr, L"Video Mixing Renderer"); 
    if (FAILED(hr)) 
    {
        pVmr->Release();
        return hr;
    }

    // 设置显示模式 
    IVMRFilterConfig* pConfig; 
    hr = pVmr->QueryInterface(IID_IVMRFilterConfig, (void**)&pConfig); 
    if (SUCCEEDED(hr)) 
    { 
        hr = pConfig->SetRenderingMode(VMRMode_Windowless); 
        pConfig->Release(); 
    }
    if (SUCCEEDED(hr))
    {
        // 设置窗体 
        hr = pVmr->QueryInterface(IID_IVMRWindowlessControl, (void**)&pWc);
        if( SUCCEEDED(hr)) 
        { 
            hr = pWc->SetVideoClippingWindow(hwndApp); 
            if (SUCCEEDED(hr))
            {
                *ppWc = pWc; //返回AddRef指针 
            }
            else
            {
                pWc->Release();
            }
        } 
    } 
    
    pVmr->Release(); 
    return hr; 
}

     该函数假设正在显示一个视频流并没有混合的静态位图。你将看到按如下调用该函数：

IVMRWindowlessControl *pWc = NULL;
hr = InitWindowlessVMR(hwnd, pGraph, &g_pWc);
if (SUCCEEDED(hr))
{
    // 建立图表
    pGraph->RenderFile(wszMyFileName, 0);
    //完成后释放VMR接口
    pWc->Release();
}

视频定位
     配置完VMR后，下一个步骤就是去设置视频显示的位置。有两个矩形位置要考虑，一个是Source矩形位置，一个是desitnation矩形位置。 Source定义视频显示的位置。Destination指定包含视频的窗体的客户区的位置。VMR从source把图像按destination的尺寸 匹配后显示出来。
     调用IVMRWindowlessControl::SetVideoPosition去指定这个两个矩形位置。Source矩形的大小必须等于或小于视频本身的尺寸大小；你可以使用IVMRWindowlessControl::GetNativeVideoSize去获得视频本身的尺寸。
     下面的实例，将设置Source等于视频尺寸1/4（左上角的位置相等），并设置destination矩形等于窗体客户区的大小1/（左上角的位置相等）：

// 获得视频自身尺寸大小
long lWidth, lHeight; 
HRESULT hr = g_pWc->GetNativeVideoSize(&lWidth, &lHeight, NULL, NULL); 
if (SUCCEEDED(hr))
{
    RECT rcSrc, rcDest; 
    // 设置Source尺寸
    SetRect(&rcSrc, 0, 0, lWidth/2, lHeight/2);     

    // 获得显示窗体的客户区尺寸
    GetClientRect(hwnd, &rcDest); 
    //设置destination尺寸
    SetRect(&rcDest, 0, 0, rcDest.right/2, rcDest.bottom/2);    

    // 视频定位
    hr = g_pWc->SetVideoPosition(&rcSrc, &rcDest); 
}

处理窗体消息
     因为VMR没有自己的窗体，当视频需要重画或者尺寸要改变是，你必须要通知窗体来适应。

• 当接收到一个WM_PAINT消息，可调用IVMRWindowlessControl::RepaintVideo 来重画图像。
• 当接收到一个WM_DISPLAYCHANGE 消息, 可调用 IVMRWindowlessControl::DisplayModeChanged消息。VMR就可以获得如下行为比如改变分辨率或者色深。
• 当接收到一个WM_SIZE 消息, 可以重新调用SetVideoPosition 来改变视频的显示位置。

     下面显示如何处理WM_PAINT消息。它将在窗体的客户区重绘，但是不会对视频显示的区域进行重绘。不对视频显示的区域进行重绘，是因为VMR会对该区 域显示视频，如果你的程序再对该区域重绘会引起屏幕闪烁。也是应为这个原因，所有不要在你窗体类中去设置背景刷。

void OnPaint(HWND hwnd) 
{ 
    PAINTSTRUCT ps; 
    HDC         hdc; 
    RECT        rcClient; 
    
    GetClientRect(hwnd, &rcClient); 
    hdc = BeginPaint(hwnd, &ps); 

    if (g_pWc != NULL) 
    { 
        // 查找窗体需要重绘的客户区，该区域应该减去视频显示的区域
        // (这里假设g_rcDest 是已经计算好了的区域)
        HRGN rgnClient = CreateRectRgnIndirect(&rcClient); 
        HRGN rgnVideo  = CreateRectRgnIndirect(&g_rcDest);  
        CombineRgn(rgnClient, rgnClient, rgnVideo, RGN_DIFF);          

        // 重绘窗体
        HBRUSH hbr = GetSysColorBrush(COLOR_BTNFACE); 
        FillRgn(hdc, rgnClient, hbr);  

        // 释放对象
        DeleteObject(hbr); 
        DeleteObject(rgnClient); 
        DeleteObject(rgnVideo);  

        // 请求VMR to 重绘视频
        HRESULT hr = g_pWc->RepaintVideo(hwnd, hdc);  
    } 
    else  // 没有视频显示，重绘整个客户区 
    { 
        FillRect(hdc, &rc2, (HBRUSH)(COLOR_BTNFACE + 1)); 
    } 
    
    EndPaint(hwnd, &ps); 
}