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 メンバーは、ビデオの変換先の四角形を指定します。 ほとんどのソース フィルターは、このメンバーをすべてのゼロに設定します。 ダウンストリーム フィルターは、ビデオを提供するバッファーの特定の領域に配置することを要求できます。 この場合、空でないターゲットを使用して、QueryAccept Win32 関数を呼び出します。
必要条件
要件 | 価値 |
---|---|
ヘッダー | ksmedia.h (Ksmedia.h を含む) |