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