VIDEOINFOHEADER 構造体

[アーティクル]
04/22/2010

VIDEOINFOHEADER 構造体は、ビデオイメージのビットマップと色情報を記述する。

構文

typedef struct tagVIDEOINFOHEADER {
    RECT                rcSource,
    RECT                rcTarget;
    DWORD               dwBitRate;
    DWORD               dwBitErrorRate;
    REFERENCE_TIME      AvgTimePerFrame;
    BITMAPINFOHEADER    bmiHeader;
} VIDEOINFOHEADER;

メンバ

rcSource

転送元ビデオウィンドウを指定する RECT 構造体。ソースビデオストリームの一部を選択するため、この構造体をクリッピング矩形としてもよい。

rcTarget

転送先ビデオウィンドウを指定する RECT 構造体。

dwBitRate

ビデオストリームのおおよそのデータレート (ビット/秒)。

dwBitErrorRate

データエラーレート (ビットエラー/秒) 。

AvgTimePerFrame

必要なビデオフレームの平均表示時間 (100 ナノ秒単位) 。実際のフレームあたりの表示時間は長くなる可能性がある。「注意」を参照。

bmiHeader

ビデオイメージのビットマップの色情報およびディメンジョン情報が格納された BITMAPINFOHEADER 構造体。フォーマットブロックにカラーテーブルまたは色マスクが含まれる場合は、bmiHeader メンバのすぐ後ろに続く。最初のカラーエントリを取得するには、メンバのアドレスを BITMAPINFO ポインタにキャストする。

注意

rcSource メンバと rcTarget メンバの使い方の詳細については、「ビデオレンダラにおける転送元矩形と転送先矩形」を参照すること。

フレームレート

AvgTimePerFrame の値は通常、ソースフィルタが設定する。ソースフィルタはメディアストリームから値を取得する。この値を使って作成時のフレームレートが計算できる。作成時のフレームレートとは、ビデオをレンダリングするためのフレームレートのことである。再生中は、システムは作成時のレートでストリームをレンダリングできないこともあるので、実際のフレームレートはこれより小さいことがある。このような状況は、マシンのリソースが過剰にコミットされた場合に起こり得る。また、モニタのリフレッシュレートがビデオの再生レートに影響する可能性もある。たとえば、目的のレートが 60,000/1001 (NTSC TV) でモニタのリフレッシュレートが 60Hz とすると、目的のレートと実際のレートは決して一致しない。再生時に達成した実際のフレームレートを取得するには、ビデオレンダラの IQualProp::get_AvgFrameRate メソッドを使う。

再生時に、アプリケーションは次の方法で作成時のフレームレートを取得できる。

古いビデオレンダラフィルタを使ってレンダリングする場合は、IBasicVideo::get_AvgTimePerFrame メソッドを呼び出すこと。
Video Mixing Renderer (VMR) を使ってレンダリングする場合は、入力ピンで IPin::ConnectionMediaType を呼び出し、フォーマットブロックを調べること。VMR は複数の入力ストリームをサポートしており、それらの入力ストリームに同じフレームレートを持たせる必要はない。

ビデオファイルの作成時のフレームレートをレンダリングしないで取得するには、IMediaDet::get_FrameRate を使うこと。

参照

DirectShow 構造体

VIDEOINFOHEADER 構造体

その他のリソース