IBasicVideo インターフェイス (control.h)

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

インターフェイスは IBasicVideo 、変換先やソースの四角形などのビデオ プロパティを設定します。 Video Renderer フィルターと Video Mixing Renderer フィルターは、このインターフェイスを実装しますが、このインターフェイスは Filter Graph Manager を介してアプリケーションに公開されます。 アプリケーションでは、常にフィルター グラフ マネージャーからこのインターフェイスを取得する必要があります。

インターフェイスは IBasicVideo 、ビデオ イメージに関連付けられている次の四角形を操作します。

• ソースの四角形は、表示される元のイメージの部分です。
• 変換先の四角形は、ソース四角形を受け取るビデオ ウィンドウの部分です。
• ビデオの四角形は、元のビデオ画像です。

言い換えると、ビデオ レンダラーはイメージをソース四角形にトリミングし、トリミングされたイメージをコピー先の四角形に拡大または縮小します。 すべての四角形の寸法はピクセル単位で指定されます。

ビデオ レンダラーで設定されたプロパティは、連続する接続と切断の間で保持されます。

エラー コード: ビデオ レンダラー フィルターが別のフィルターに接続されていない場合、すべてのメソッドはエラー コード VFW_E_NOT_CONNECTEDを返します。 Filter Graph Manager の実装では、グラフにビデオ レンダラー フィルターが含まれていない場合、すべてのメソッドはE_NOINTERFACEを返します。 フィルター グラフ マネージャーは、グラフにビデオ レンダラーが含まれていない場合でもインターフェイスを公開するため、アプリケーションはグラフをビルドする前にインターフェイスのクエリを実行できます。

継承

IBasicVideo インターフェイスは、IDispatch インターフェイスから継承されます。 IBasicVideo には、次の種類のメンバーもあります。

メソッド

IBasicVideo インターフェイスには、これらのメソッドがあります。

IBasicVideo::get_AvgTimePerFrame get_AvgTimePerFrame メソッドは、連続するフレーム間の平均時間を取得します。
IBasicVideo::get_BitErrorRate get_BitErrorRate メソッドは、ビデオ ストリームのおおよそのビット エラー 率を取得します。
IBasicVideo::get_BitRate get_BitRate メソッドは、ビデオ ストリームのおおよそのビット レートを取得します。
IBasicVideo::get_DestinationHeight get_DestinationHeight メソッドは、変換先の四角形の高さを取得します。
IBasicVideo::get_DestinationLeft get_DestinationLeft メソッドは、変換先の四角形の x 座標を取得します。
IBasicVideo::get_DestinationTop get_DestinationTop メソッドは、変換先の四角形の y 座標を取得します。
IBasicVideo::get_DestinationWidth get_DestinationWidth メソッドは、変換先の四角形の幅を取得します。
IBasicVideo::get_SourceHeight get_SourceHeight メソッドは、ソース四角形の高さを取得します。
IBasicVideo::get_SourceLeft get_SourceLeft メソッドは、ソース四角形の x 座標を取得します。
IBasicVideo::get_SourceTop get_SourceTop メソッドは、ソース四角形の y 座標を取得します。
IBasicVideo::get_SourceWidth get_SourceWidth メソッドは、ソース四角形の幅を取得します。
IBasicVideo::get_VideoHeight get_VideoHeight メソッドは、ビデオのネイティブの高さを取得します。
IBasicVideo::get_VideoWidth get_VideoWidth メソッドは、ビデオのネイティブ幅を取得します。
IBasicVideo::GetCurrentImage GetCurrentImage メソッドは、レンダラーで待機している現在のイメージを取得します。
IBasicVideo::GetDestinationPosition GetDestinationPosition メソッドは、移動先の四角形の位置を取得します。
IBasicVideo::GetSourcePosition GetSourcePosition メソッドは、ソース四角形の位置を取得します。
IBasicVideo::GetVideoPaletteEntries GetVideoPaletteEntries メソッドは、ビデオのパレットの色を取得します。
IBasicVideo::GetVideoSize GetVideoSize メソッドは、ネイティブ ビデオ ディメンションを取得します。
IBasicVideo::IsUsingDefaultDestination IsUsingDefaultDestination メソッドは、レンダラーが既定の変換先の四角形を使用しているかどうかを照会します。
IBasicVideo::IsUsingDefaultSource IsUsingDefaultSource メソッドは、レンダラーが既定のソース四角形を使用しているかどうかを照会します。
IBasicVideo::p ut_DestinationHeight put_DestinationHeight メソッドは、変換先の四角形の高さを設定します。
IBasicVideo::p ut_DestinationLeft put_DestinationLeft メソッドは、変換先の四角形の x 座標を設定します。
IBasicVideo::p ut_DestinationTop put_DestinationTop メソッドは、変換先の四角形の y 座標を設定します。
IBasicVideo::p ut_DestinationWidth put_DestinationWidth メソッドは、移動先の四角形の幅を設定します。
IBasicVideo::p ut_SourceHeight put_SourceHeight メソッドは、ソース四角形の高さを設定します。
IBasicVideo::p ut_SourceLeft put_SourceLeft メソッドは、ソース四角形の x 座標を設定します。
IBasicVideo::p ut_SourceTop put_SourceTopメソッドは、ソース四角形の y 座標を設定します。
IBasicVideo::p ut_SourceWidth put_SourceWidth メソッドは、ソース四角形の幅を設定します。
IBasicVideo::SetDefaultDestinationPosition SetDefaultDestinationPosition メソッドは、既定の変換先の四角形に戻ります。 このメソッドが呼び出されると、ビデオ レンダラーは再生にウィンドウ全体を使用します。
IBasicVideo::SetDefaultSourcePosition SetDefaultSourcePosition メソッドは、既定のソース四角形に戻ります。 このメソッドが呼び出されると、ビデオ レンダラーはトリミングせずにビデオ イメージ全体を使用します。
IBasicVideo::SetDestinationPosition SetDestinationPosition メソッドは、変換先の四角形を設定します。
IBasicVideo::SetSourcePosition SetSourcePosition メソッドは、ソースの四角形を設定します。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	control.h (Dshow.h を含む)

こちらもご覧ください

IDispatch