IMSVidVideoRenderer

IMSVidVideoRenderer インターフェイスは、ビデオレンダラーデバイスを表します。MSVidVideoRenderer オブジェクトがこのインターフェイスを公開します。このインターフェイスは、Video Mixing Renderer (VMR) フィルターへのアクセスを提供します。

このインターフェイスのインターフェイス識別子 (IID) を宣言するには、__uuidof 演算子を使用します: __uuidof(IMSVidVideoRenderer)。

get_CustomCompositorClass メソッドは、Video Mixing Renderer の現在のイメージコンポジターのクラス識別子 (CLSID) を BSTR として取得します。

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

このメソッドは Automation クライアント向けに提供されています。C++ アプリケーションでは、BSTR ではなく GUID を返す IMSVidVideoRenderer::get__CustomCompositorClass メソッドを使用できます。

呼び出し元は、返された文字列を SysFreeString 関数を使用して解放する必要があります。

put_CustomCompositorClass メソッドは、カスタムイメージコンポジターのクラス識別子 (CLSID) を BSTR として指定します。

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

このメソッドは Automation クライアント向けに提供されています。C++ アプリケーションでは、BSTR ではなく GUID を指定する IMSVidVideoRenderer::put__CustomCompositorClass メソッドを使用できます。

get__CustomCompositorClass メソッドは、Video Mixing Renderer の現在のイメージコンポジターのクラス識別子 (CLSID) を GUID として取得します。

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

アプリケーションは、カスタムのイメージコンポジット処理を行うために独自のコンポジターを提供できます。詳細については、Using the Video Mixing Renderer を参照してください。

put__CustomCompositorClass メソッドは、カスタムイメージコンポジターのクラス識別子 (CLSID) を GUID として指定します。

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

アプリケーションは、カスタムのイメージコンポジット処理を行うために独自のコンポジターを提供できます。詳細については、Using the Video Mixing Renderer を参照してください。

get__CustomCompositor メソッドは、Video Mixing Renderer の現在のイメージコンポジターを取得します。

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

アプリケーションは、カスタムのイメージコンポジット処理を行うために独自のコンポジターを提供できます。詳細については、Using the Video Mixing Renderer を参照してください。

返される IVMRImageCompositor インターフェイスは、未解放の参照カウントを持っています。呼び出し元はこのインターフェイスを解放する必要があります。

put__CustomCompositor メソッドは、Video Mixing Renderer (VMR) が使用するカスタムイメージコンポジターを指定します。

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

アプリケーションは、カスタムのイメージコンポジット処理を行うために独自のコンポジターを提供できます。詳細については、Using the Video Mixing Renderer を参照してください。

get_MixerBitmap メソッドは、静的なビットマップイメージを IPictureDisp 型として取得します。

HRESULT 値を返します。可能な値には次のものがあります。

静的なビットマップイメージが設定されている場合、VMR はそのビットマップをビデオイメージにアルファブレンドします。IPictureDisp インターフェイスの詳細については、Platform SDK のドキュメントを参照してください。

get__MixerBitmap メソッドは、VMR が静的なビットマップをミックスする方法を制御する Video Mixing Renderer の IVMRMixerBitmap インターフェイスを取得します。

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

返される IVMRMixerBitmap インターフェイスは、未解放の参照カウントを持っています。呼び出し元はこのインターフェイスを解放する必要があります。

put_MixerBitmap メソッドは、静的なビットマップイメージを IPictureDisp 型として指定します。

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

VMR は、静的なビットマップイメージをビデオイメージにアルファブレンドします。IPictureDisp インターフェイスの詳細については、Platform SDK のドキュメントを参照してください。

put__MixerBitmap メソッドは、静的なビットマップイメージを指定します。

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

get_MixerBitmapPositionRect メソッドは、ビデオウィンドウを基準とした静的なビットマップイメージの位置を取得します。

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

静的なビットマップイメージが設定されている場合、VMR は pprDest で指定された位置矩形を使用して、そのビットマップをビデオイメージにアルファブレンドします。

返される IMSVidRect インターフェイスは、未解放の参照カウントを持っています。呼び出し元はこのインターフェイスを解放する必要があります。

put_MixerBitmapPositionRect メソッドは、ビデオウィンドウを基準とした静的なビットマップイメージの位置を指定します。

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

静的なビットマップイメージが設定されている場合、VMR は指定された位置矩形を使用して、そのビットマップをビデオイメージにアルファブレンドします。

get_MixerBitmapOpacity メソッドは、静的なビットマップイメージの不透明度を取得します。

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

静的なビットマップイメージが設定されている場合、VMR は pOpacity で指定された不透明度を使用して、そのビットマップをビデオイメージにアルファブレンドします。

put_MixerBitmapOpacity メソッドは、静的なビットマップイメージの不透明度を指定します。

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

静的なビットマップイメージが設定されている場合、VMR は指定された不透明度を使用して、そのビットマップをビデオイメージにアルファブレンドします。

SetupMixerBitmap メソッドは、ビデオの上にアルファブレンドされたビットマップを表示するように Video Mixing Renderer (VMR) を構成します。

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

get_SourceSize メソッドは、ビデオ矩形に適用するクリッピングの種類 (存在する場合) を取得します。

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

put_SourceSize メソッドは、ビデオ矩形に適用するクリッピングの種類 (存在する場合) を指定します。

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

get_OverScan メソッドは、ランダムなビデオノイズを取り除くために、ビデオフレームのすべての辺に対して実行するクリッピングの量を取得します。

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

現在のクリッピングモードが sslClipByOverScan の場合、VMR は plPercent パラメーターで指定された量だけビデオイメージをクリッピングします。詳細については、IMSVidVideoRenderer::put_SourceSize を参照してください。

put_OverScan メソッドは、ランダムなビデオノイズを取り除くために、ビデオフレームのすべての辺に対して実行するクリッピングの量を指定します。

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

現在のクリッピングモードが sslClipByOverScan の場合、VMR は指定された量だけビデオイメージをクリッピングします。詳細については、IMSVidVideoRenderer::put_SourceSize を参照してください。

get_AvailableSourceRect メソッドは、ネイティブビデオのサイズを取得します。

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

返される IMSVidRect インターフェイスは、未解放の参照カウントを持っています。呼び出し元はこのインターフェイスを解放する必要があります。

get_MaxVidRect メソッドは、ビデオ矩形の理想的な最大サイズを取得します。

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

理想的な最大イメージサイズとは、パフォーマンスやイメージ品質を著しく低下させることなく表示できる最大のビデオサイズです。

返される IMSVidRect インターフェイスは、未解放の参照カウントを持っています。呼び出し元はこのインターフェイスを解放する必要があります。

get_MinVidRect メソッドは、ビデオ矩形の理想的な最小サイズを取得します。

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

理想的な最小イメージサイズとは、パフォーマンスやイメージ品質を著しく低下させることなく表示できる最小のビデオサイズです。

返される IMSVidRect インターフェイスは、未解放の参照カウントを持っています。呼び出し元はこのインターフェイスを解放する必要があります。

get_ClippedSourceRect メソッドは、ビデオソース上のクリッピング矩形を取得します。

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

現在のクリッピングモードが sslClipByClipRect の場合、VMR はビデオイメージをビデオソース矩形にクリッピングし、クリッピングされたイメージを引き伸ばして Video Control のビデオウィンドウを埋めます。詳細については、IMSVidVideoRenderer::put_SourceSize を参照してください。

返される IMSVidRect インターフェイスは、未解放の参照カウントを持っています。呼び出し元はこのインターフェイスを解放する必要があります。

put_ClippedSourceRect メソッドは、ビデオソース上のクリッピング矩形を指定します。

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

現在のクリッピングモードが sslClipByClipRect の場合、VMR はビデオイメージをビデオソース矩形にクリッピングし、これを引き伸ばして Video Control のビデオウィンドウを埋めます。詳細については、IMSVidVideoRenderer::put_SourceSize を参照してください。

使用例

次の例では、ビデオイメージをソース矩形の左上隅にクリッピングします。

CComPtr<IMSVidVideoRenderer> pVideo;
HRESULT hr = pVideoControl->get_VideoRendererActive(&pVideo);
if (SUCCEEDED(hr))
{
    long lWidth, lHeight;
    CComPtr<IMSVidRect> pRect;
    
    hr = pVideo->get_AvailableSourceRect(&pRect);
    pRect->get_Height(&lHeight);
    pRect->get_Width(&lWidth);
    pRect->put_Height(lHeight / 2);
    pRect->put_Width(lWidth / 2);
    pVideo->put_SourceSize(sslClipByClipRect);
    hr = pVideo->put_ClippedSourceRect(pRect);
}

get_UsingOverlay メソッドは、Video Mixing Renderer (VMR) がハードウェアオーバーレイを使用しているかどうかを照会します。

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

put_UsingOverlay メソッドは、Video Mixing Renderer がハードウェアオーバーレイを使用するかどうかを指定します。

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

Capture メソッドは、Video Mixing Renderer (VMR) によって現在レンダリングされているビデオフレームをキャプチャします。

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

返される IPictureDisp インターフェイスは、未解放の参照カウントを持っています。呼び出し元はこのインターフェイスを解放する必要があります。

IPictureDisp インターフェイスの詳細については、Microsoft Platform SDK のドキュメントを参照してください。

使用例

CComPtr<IMSVidCtl> m_pVideoControl; // Video Control へのポインター。

/* フィルターグラフを構築して実行します (ここでは省略)。 */

// ビデオレンダラーを検索します
CComPtr<IMSVidVideoRenderer> pVideo;
hr = m_pVideoControl->get_VideoRendererActive(&pVideo);
if (SUCCEEDED(hr))
{
    // イメージをキャプチャします。
    CComPtr<IPictureDisp> pPic;
    hr = pVideo->Capture(&pPic);
}

get_FramesPerSecond メソッドは、現在のフレームレートを取得します。

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

get_DecimateInput メソッドは、Video Mixing Renderer (VMR) が処理前にビデオをデシメート (すなわち、ネイティブビデオサイズを縮小) するよう現在構成されているかどうかを照会します。

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

このプロパティは、ネイティブビデオストリームが HDTV であるにもかかわらずシステムモニターがより低い解像度に設定されている場合に true に設定する必要があります。これにより、VMR がビデオを高解像度で処理してから縮小するという不要な作業を行うのを防ぎます。

put_DecimateInput メソッドは、Video Mixing Renderer (VMR) が処理前にビデオをデシメート (すなわち、ネイティブビデオサイズを縮小) するかどうかを指定します。

メソッドが成功した場合は S_OK を返します。失敗した場合はエラーコードを返します。

このプロパティは、ネイティブビデオストリームが HDTV であるにもかかわらずシステムモニターがより低い解像度に設定されている場合に true に設定する必要があります。これにより、VMR がビデオを高解像度で処理してから縮小するという不要な作業を行うのを防ぎます。