KS_VIDEOINFO構造体 (ksmedia.h)
KS_VIDEOINFO構造体は、ビデオ ストリームのビットマップと色の情報を記述します。
構文
typedef struct tagKS_VIDEOINFO {
RECT rcSource;
RECT rcTarget;
DWORD dwBitRate;
DWORD dwBitErrorRate;
REFERENCE_TIME AvgTimePerFrame;
KS_BITMAPINFOHEADER bmiHeader;
union {
KS_RGBQUAD bmiColors[KS_iPALETTE_COLORS];
DWORD dwBitMasks[KS_iMASK_COLORS];
KS_TRUECOLORINFO TrueColorInfo;
};
} KS_VIDEOINFO, *PKS_VIDEOINFO;
メンバー
rcSource
使用するアクティブなビデオ信号の部分を選択するクリッピング四角形を指定します。
rcTarget
使用するターゲット バッファーのどの部分を示す四角形を指定します。
dwBitRate
ビデオ ストリームのおおよそのデータ レートを 1 秒あたりのビット数で示す値を指定します。
dwBitErrorRate
ビデオ ストリームのデータ エラー率を 1 秒あたりのビット エラー数で示す値を指定します。
AvgTimePerFrame
フレームあたりの平均時間を 100 ナノ秒単位で指定します。
bmiHeader
ビデオ イメージ ビットマップに関する色とディメンション情報を含む KS_BITMAPINFOHEADER 構造体について説明します。
bmiColors[KS_iPALETTE_COLORS]
ビデオのカラー パレットを指定するKS_RGBQUAD構造体の配列。 各構造体は、赤、緑、青の各強度の組み合わせである単一の色を表します。
dwBitMasks[KS_iMASK_COLORS]
true 色のビットマスクを指定する DWORD 値の配列。
TrueColorInfo
KS_TRUECOLORINFO カラー パレットとカラー ビットマスクの配列の両方を含む構造体です。
注釈
この構造体は、KS_BITMAPINFOHEADER メンバーの biSize メンバーが sizeof(KS_BITMAPINFOHEADER) に設定されている場合を除き、使用しないでください。
ソース フィルターは、 rcSource メンバーでクリッピング四角形を効果的に定義する値を提供することで、シンク フィルターがビデオのセクションのみを受け取るように要求できます。 ただし、シンク フィルターが接続時にクリッピング四角形にチェックしない場合、シンク フィルターは単にすべてのビデオをレンダリングし、ソース フィルターからシンク フィルターに渡されたクリッピング情報を実質的に無視します。
理想的には、シンク フィルターは rcSource を チェックし、シンク フィルターがイメージ抽出をサポートせず、四角形が空 でない 場合は、接続を拒否します。 フィルターでは、Win32 関数 SetRectEmpty を使用して、四角形をすべてのゼロ (および後で四角形チェックに IsRectEmpty) にリセットする必要があります。
rcTarget メンバーは、ビデオの変換先の四角形を指定します。 ほとんどのソース フィルターは、このメンバーをすべてのゼロに設定します。 ダウンストリーム フィルターは、ビデオを提供するバッファーの特定の領域に配置することを要求できます。 この場合、Win32 関数 QueryAccept を空でないターゲットで呼び出します。
要件
| 要件 | 値 |
|---|---|
| Header | ksmedia.h (Ksmedia.h を含む) |