KS_VIDEOINFOHEADER 構造体 (ksmedia.h)

  • [アーティクル]

KS_VIDEOINFOHEADER構造体は、ビデオ ストリームのビットマップと色の情報を記述します。

構文

typedef struct tagKS_VIDEOINFOHEADER {
  RECT                rcSource;
  RECT                rcTarget;
  DWORD               dwBitRate;
  DWORD               dwBitErrorRate;
  REFERENCE_TIME      AvgTimePerFrame;
  KS_BITMAPINFOHEADER bmiHeader;
} KS_VIDEOINFOHEADER, *PKS_VIDEOINFOHEADER;

メンバー

rcSource

使用するアクティブなビデオ信号の部分を選択するクリッピング四角形を指定します。

rcTarget

ターゲットのビデオ ウィンドウを定義する四角形を指定します。

dwBitRate

ビデオ ストリームのおおよそのデータ レートを 1 秒あたりのビット数で示す値を指定します。

dwBitErrorRate

ビデオ ストリームのデータ エラー率を 1 秒あたりのビット エラー数で示す値を指定します。

AvgTimePerFrame

フレームあたりの平均時間を 100 ナノ秒単位で指定します。

bmiHeader

ビデオ イメージ ビットマップに関する色とディメンション情報を含む KS_BITMAPINFOHEADER 構造体について説明します。

注釈

bob または weave の設定でビデオ ストリームを記述するには、 KS_VIDEOINFOHEADER2を使用します。

KS_VIDEOINFOHEADER構造体は、Microsoft DirectShow VIDEOINFOHEADER 構造体と同じです。

ソース フィルターは、 rcSource メンバーでクリッピング四角形を効果的に定義する値を提供することで、シンク フィルターがビデオのセクションのみを受け取るように要求できます。 ただし、シンク フィルターが接続時にクリッピング四角形にチェックしない場合、シンク フィルターは単にすべてのビデオをレンダリングし、ソース フィルターからシンク フィルターに渡されたクリッピング情報を実質的に無視します。

理想的には、シンク フィルターは rcSource を チェックし、シンク フィルターがイメージ抽出をサポートせず、四角形が空 でない 場合は、接続を拒否します。 フィルターでは、Win32 関数 SetRectEmpty を使用して四角形をすべてのゼロにリセットする必要があります (また、後で四角形チェックに IsRectEmpty を設定します)。

rcTarget メンバーは、ビデオの変換先の四角形を指定します。 ほとんどのソース フィルターは、このメンバーをすべてのゼロに設定します。 ダウンストリーム フィルターは、ビデオを提供するバッファーの特定の領域に配置することを要求できます。 この場合、Win32 関数 QueryAccept を空でないターゲットで呼び出します。

要件

要件 値
Header ksmedia.h (Ksmedia.h を含む)

こちらもご覧ください

KS_BITMAPINFOHEADER

KS_VIDEOINFOHEADER2