ウィンドウレスモードの使用

[アーティクル]
06/21/2023

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、Media Foundation のオーディオ/ビデオキャプチャに置き換わりました。これらの機能は、Windows 10とWindows 11用に最適化されています。新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]

ビデオミキシングレンダラーフィルター 7 (VMR-7) とビデオミキシングレンダラーフィルター 9 (VMR-9) の両方でウィンドウレスモードがサポートされています。これは、IVideoWindow インターフェイスに対する大幅な改善を表します。このトピックでは、ウィンドウレスモードとウィンドウモードの違いと、ウィンドウレスモードの使用方法について説明します。

既存のアプリケーションとの下位互換性を維持するために、VMR は既定でウィンドウモードになります。ウィンドウモードでは、レンダラーはビデオを表示する独自のウィンドウを作成します。通常、アプリケーションはビデオウィンドウをアプリケーションウィンドウの子に設定します。ただし、別のビデオウィンドウが存在すると、いくつかの問題が発生します。

最も重要なのは、スレッド間でウィンドウメッセージが送信された場合にデッドロックが発生する可能性があることです。
フィルターグラフマネージャーは、WM_PAINTなどの特定のウィンドウメッセージをビデオレンダラーに転送する必要があります。フィルターグラフマネージャーが正しい内部状態を維持するには、アプリケーションでフィルターグラフマネージャーの IVideoWindow の実装 (ビデオレンダラーではなく) を使用する必要があります。
ビデオウィンドウからマウスまたはキーボードイベントを受信するには、アプリケーションで メッセージドレインを設定する必要があります。これにより、ビデオウィンドウでこれらのメッセージがアプリケーションに転送されます。
クリッピングの問題を防ぐには、ビデオウィンドウに適切なウィンドウスタイルが必要です。

ウィンドウレスモードでは、VMR をアプリケーションウィンドウのクライアント領域に直接描画し、DirectDraw を使用してビデオの四角形をクリップすることで、これらの問題を回避できます。ウィンドウレスモードでは、デッドロックの可能性が大幅に低下します。また、アプリケーションで所有者ウィンドウまたはウィンドウスタイルを設定する必要はありません。実際、VMR がウィンドウレスモードの場合、 不要になった IVideoWindow インターフェイスも公開されません。

ウィンドウレスモードを使用するには、VMR を明示的に構成する必要があります。ただし、ウィンドウモードよりも柔軟性が高く、使いやすいことがわかります。

VMR-7 フィルターと VMR-9 フィルターは異なるインターフェイスを公開しますが、手順はそれぞれ同じです。

ウィンドウレスモード用に VMR を構成する

VMR の既定の動作をオーバーライドするには、フィルターグラフを作成する前に VMR を構成します。

VMR-7

フィルターグラフマネージャーを作成します。
VMR-7 を作成し、フィルターグラフに追加します。
VMRMODE_WINDOWLESS フラグを使用して、VMR-7 で IVMRFilterConfig::SetRenderingMode を呼び出します。
IVMRWindowlessControl インターフェイスの VMR-7 に対してクエリを実行します。
VMR-7 で IVMRWindowlessControl::SetVideoClippingWindow を呼び出します。ビデオが表示されるウィンドウへのハンドルを指定します。

VMR-9

フィルターグラフマネージャーを作成します。
VMR-9 を作成し、フィルターグラフに追加します。
VMR9MODE_WINDOWLESS フラグを使用して、VMR-9 で IVMRFilterConfig9::SetRenderingMode を呼び出します。
IVMRWindowlessControl9 インターフェイスの VMR-9 に対してクエリを実行します。
VMR-9 で IVMRWindowlessControl9::SetVideoClippingWindow を呼び出します。ビデオが表示されるウィンドウへのハンドルを指定します。

次に、 IGraphBuilder::RenderFile またはその他のグラフ構築メソッドを呼び出して、フィルターグラフの残りの部分をビルドします。フィルターグラフマネージャーでは、グラフに追加した VMR のインスタンスが自動的に使用されます。 (これが発生する理由の詳細については、「 Intelligent Connect」を参照してください)。

次のコードは、VMR-7 を作成してグラフに追加し、ウィンドウレスモードを設定するヘルパー関数を示しています。

HRESULT InitWindowlessVMR( 
    HWND hwndApp,                  // Window to hold the video. 
    IGraphBuilder* pGraph,         // Pointer to the Filter Graph Manager. 
    IVMRWindowlessControl** ppWc   // Receives a pointer to the VMR.
    ) 
{ 
    if (!pGraph || !ppWc) 
    {
        return E_POINTER;
    }
    IBaseFilter* pVmr = NULL; 
    IVMRWindowlessControl* pWc = NULL; 
    // Create the VMR. 
    HRESULT hr = CoCreateInstance(CLSID_VideoMixingRenderer, NULL, 
        CLSCTX_INPROC, IID_IBaseFilter, (void**)&pVmr); 
    if (FAILED(hr))
    {
        return hr;
    }
    
    // Add the VMR to the filter graph.
    hr = pGraph->AddFilter(pVmr, L"Video Mixing Renderer"); 
    if (FAILED(hr)) 
    {
        pVmr->Release();
        return hr;
    }
    // Set the rendering mode.  
    IVMRFilterConfig* pConfig; 
    hr = pVmr->QueryInterface(IID_IVMRFilterConfig, (void**)&pConfig); 
    if (SUCCEEDED(hr)) 
    { 
        hr = pConfig->SetRenderingMode(VMRMode_Windowless); 
        pConfig->Release(); 
    }
    if (SUCCEEDED(hr))
    {
        // Set the window. 
        hr = pVmr->QueryInterface(IID_IVMRWindowlessControl, (void**)&pWc);
        if( SUCCEEDED(hr)) 
        { 
            hr = pWc->SetVideoClippingWindow(hwndApp); 
            if (SUCCEEDED(hr))
            {
                *ppWc = pWc; // Return this as an AddRef'd pointer. 
            }
            else
            {
                // An error occurred, so release the interface.
                pWc->Release();
            }
        } 
    } 
    pVmr->Release(); 
    return hr; 
}

この関数は、1 つのビデオストリームのみを表示し、ビデオに静的ビットマップを混在させないことを前提としています。詳細については、「 VMR ウィンドウレスモード」を参照してください。この関数は次のように呼び出します。

IVMRWindowlessControl *pWc = NULL;
hr = InitWindowlessVMR(hwnd, pGraph, &g_pWc);
if (SUCCEEDED(hr))
{
    // Build the graph. For example:
    pGraph->RenderFile(wszMyFileName, 0);
    // Release the VMR interface when you are done.
    pWc->Release();
}

ビデオの配置

VMR を構成した後、次の手順はビデオの位置を設定することです。考慮すべき四角形は、 ソース 四角形と 変換先 の四角形の 2 つあります。ソース四角形は、表示するビデオの部分を定義します。変換先の四角形は、ビデオを含むウィンドウのクライアント領域の領域を指定します。 VMR は、ビデオイメージをソース四角形にトリミングし、トリミングされたイメージをコピー先の四角形に合わせて拡大します。

VMR-7

両方の四角形を指定するには、 IVMRWindowlessControl::SetVideoPosition メソッドを呼び出します。
ソースの四角形は、ネイティブビデオサイズと同じか小さい必要があります。 IVMRWindowlessControl::GetNativeVideoSize メソッドを使用して、ネイティブビデオサイズを取得できます。

VMR-9

IVMRWindowlessControl9::SetVideoPosition メソッドを呼び出して、両方の四角形を指定します。
ソースの四角形は、ネイティブビデオサイズと同じか小さい必要があります。 IVMRWindowlessControl9::GetNativeVideoSize メソッドを使用して、ネイティブビデオサイズを取得できます。

たとえば、次のコードでは、VMR-7 のソース四角形と変換先の四角形を設定します。ソースの四角形をビデオイメージ全体に設定し、変換先の四角形をウィンドウクライアント領域全体に設定します。

// Find the native video size.
long lWidth, lHeight; 
HRESULT hr = g_pWc->GetNativeVideoSize(&lWidth, &lHeight, NULL, NULL); 
if (SUCCEEDED(hr))
{
    RECT rcSrc, rcDest; 
    // Set the source rectangle.
    SetRect(&rcSrc, 0, 0, lWidth, lHeight); 
    
    // Get the window client area.
    GetClientRect(hwnd, &rcDest); 
    // Set the destination rectangle.
    SetRect(&rcDest, 0, 0, rcDest.right, rcDest.bottom); 
    
    // Set the video position.
    hr = g_pWc->SetVideoPosition(&rcSrc, &rcDest); 
}

クライアント領域の小さな部分を占めるビデオを作成する場合は、 rcDest パラメーターを変更します。ビデオイメージをトリミングする場合は、 rcSrc パラメーターを変更します。

ウィンドウメッセージの処理

VMR には独自のウィンドウがないため、ビデオを再描画またはサイズ変更する必要がある場合は、通知を受け取る必要があります。一覧表示されている VMR メソッドを呼び出して、次のウィンドウメッセージに応答します。

VMR-7

WM_PAINT。 IVMRWindowlessControl::RepaintVideo を呼び出します。この方法により、VMR-7 は最新のビデオフレームを再描画します。
WM_DISPLAYCHANGE: IVMRWindowlessControl::D isplayModeChanged を呼び出します。このメソッドは、ビデオを新しい解像度または色深度で表示する必要があることを VMR-7 に通知します。
WM_SIZE または WM_WINDOWPOSCHANGED: ビデオの位置を再計算し、 IVMRWindowlessControl::SetVideoPosition を呼び出して、必要に応じて位置を更新します。

VMR-9

WM_PAINT。 IVMRWindowlessControl9::RepaintVideo を呼び出します。この方法により、VMR-9 は最新のビデオフレームを再描画します。
WM_DISPLAYCHANGE: IVMRWindowlessControl9::D isplayModeChanged を呼び出します。このメソッドは、ビデオを新しい解像度または色深度で表示する必要があることを VMR-9 に通知します。
WM_SIZE または WM_WINDOWPOSCHANGED: ビデオの位置を再計算し、 IVMRWindowlessControl9::SetVideoPosition を呼び出して、必要に応じて位置を更新します。

注意

WM_WINDOWPOSCHANGED メッセージの既定のハンドラーは、WM_SIZE メッセージを送信します。ただし、アプリケーションがWM_WINDOWPOSCHANGEDをインターセプトし、DefWindowProc に渡さない場合は、WM_SIZE ハンドラーに加えて、WM_WINDOWPOSCHANGED ハンドラーで 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) 
    { 
        // Find the region where the application can paint by subtracting 
        // the video destination rectangle from the client area.
        // (Assume that g_rcDest was calculated previously.)
        HRGN rgnClient = CreateRectRgnIndirect(&rcClient); 
        HRGN rgnVideo  = CreateRectRgnIndirect(&g_rcDest);  
        CombineRgn(rgnClient, rgnClient, rgnVideo, RGN_DIFF);  
        
        // Paint on window.
        HBRUSH hbr = GetSysColorBrush(COLOR_BTNFACE); 
        FillRgn(hdc, rgnClient, hbr); 

        // Clean up.
        DeleteObject(hbr); 
        DeleteObject(rgnClient); 
        DeleteObject(rgnVideo); 

        // Request the VMR to paint the video.
        HRESULT hr = g_pWc->RepaintVideo(hwnd, hdc);  
    } 
    else  // There is no video, so paint the whole client area. 
    { 
        FillRect(hdc, &rc2, (HBRUSH)(COLOR_BTNFACE + 1)); 
    } 
    EndPaint(hwnd, &ps); 
}

WM_PAINTメッセージに応答する必要がありますが、ビデオを更新するためにメッセージWM_PAINT間で行う必要はありません。この例に示すように、ウィンドウレスモードでは、ビデオイメージをウィンドウ上の自己描画領域として扱うことができます。

ビデオミキシングレンダラーの使用
ビデオのレンダリング

ウィンドウレスモードの使用

ウィンドウレスモード用に VMR を構成する

ビデオの配置

ウィンドウメッセージの処理

フィードバック

フィードバック

その他のリソース

ウィンドウレス モードの使用

ウィンドウレス モード用に VMR を構成する

ビデオの配置

ウィンドウ メッセージの処理

関連トピック

フィードバック

フィードバック

その他のリソース

ウィンドウレスモードの使用

ウィンドウレスモード用に VMR を構成する

ウィンドウメッセージの処理