KS_VIDEOINFOHEADER2構造体 (ksmedia.h)

[アーティクル]
02/07/2025

KS_VIDEOINFOHEADER2構造体は、bob または織り込みの設定、コピー保護、ピクセル縦横比など、ビデオストリームの詳細を記述します。

構文

typedef struct tagKS_VIDEOINFOHEADER2 {
  RECT                rcSource;
  RECT                rcTarget;
  DWORD               dwBitRate;
  DWORD               dwBitErrorRate;
  REFERENCE_TIME      AvgTimePerFrame;
  DWORD               dwInterlaceFlags;
  DWORD               dwCopyProtectFlags;
  DWORD               dwPictAspectRatioX;
  DWORD               dwPictAspectRatioY;
  union {
    DWORD dwControlFlags;
    DWORD dwReserved1;
  };
  DWORD               dwReserved2;
  KS_BITMAPINFOHEADER bmiHeader;
} KS_VIDEOINFOHEADER2, *PKS_VIDEOINFOHEADER2;

メンバーズ

rcSource

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

rcTarget

使用するターゲットバッファーの部分を示す四角形を指定します。

dwBitRate

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

dwBitErrorRate

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

AvgTimePerFrame

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

dwInterlaceFlags

インターレース情報を指定します。未定義のフラグは 0 に設定する必要があります。または、接続が拒否される可能性があります。このメンバーは、ksmedia.hで定義されている 1 つ以上の (論理 OR) 値に設定できます。

旗	形容
KS_INTERLACE_IsInterlaced	インターレースストリームを示します。 0 の場合、他のKS_INTERLACE_Xxx ビットは無関係です。
KS_INTERLACE_1FieldPerSample	メディアサンプルごとに 1 つのフィールドを示します。 0 の場合は、メディアサンプルごとに 2 つのフィールドを示します。
KS_INTERLACE_Field1First	フィールド 1 が最初であることを示します。 0 の場合は、フィールド 2 が最初であることを示します。 PAL のトップフィールドはフィールド 1、NTSC のトップフィールドはフィールド 2 です。
KS_INTERLACE_UNUSED	未使用
KS_INTERLACE_FieldPatternMask	フィールドパターンの指定に使用されるビットを示します。
KS_INTERLACE_FieldPatField1Only	ストリームにフィールド 2 が含まれることはありません。
KS_INTERLACE_FieldPatField2Only	ストリームにフィールド 1 が含まれることはありません。
KS_INTERLACE_FieldPatBothRegular	フィールド 1 ごとにフィールド 2 があることを示します。
KS_INTERLACE_FieldPatBothIrregular	フィールド 1 とフィールド 2 のランダムパターンを示します。
KS_INTERLACE_DisplayModeMask	ビデオキャプチャでは無効です。
KS_INTERLACE_DisplayModeBobOnly	ビデオキャプチャでは無効です。
KS_INTERLACE_DisplayModeWeaveOnly	ビデオキャプチャでは無効です。
KS_INTERLACE_DisplayModeBobOrWeave	ビデオキャプチャでは無効です。

dwCopyProtectFlags

ストリームの重複を制限するかどうかを示す KSCOPYPROTECTRestrictDuplication 値 (0x00000001) を指定します。未定義の場合は、ゼロを指定するか、接続が拒否されます。

dwPictAspectRatioX

図の縦横比の x 寸法を指定します (たとえば、16 × 9 ディスプレイの場合は 16)。この値は、ピクセル単位ではなくインチ単位で表されます。

dwPictAspectRatioY

図の縦横比の y 寸法を指定します (たとえば、16 × 9 表示の場合は 9)。この値は、ピクセル単位ではなくインチ単位で表されます。

dwControlFlags

Windows Vista より前のオペレーティングシステムでは、このメンバーは dwReserved1 名前が付けられ、0 である必要があります。 Windows Vista では、dwReserved1 は、dwControlFlags という名前新しいメンバーとの共用体で結合されました。使用する場合、dwControlFlags には、次の表のフラグのビットごとの OR が含まれます。

価値	形容
AMCONTROL_USED	dwControlFlags フラグが使用を示します。
AMCONTROL_PAD_TO_4x3	画像を埋め込み、4 x 3 の領域に表示する必要があります。
AMCONTROL_PAD_TO_16x9	画像は 16 x 9 の領域に埋め込んで表示する必要があります。
AMCONTROL_COLORINFO_PRESENT	追加の色情報は、dwControlFlags フィールドの上位 24 ビットに含まれています。

AMCONTROL_USED フラグは、以前のフィルターとの下位互換性を提供します。 AMCONTROL_USED フラグが設定されていない場合、このフィールドの残りのビットは無視する必要があります。フィルターが他のフラグを使用する場合は、AMCONTROL_USED フラグを設定する必要があります。

デコーダーは、2 つのAMCONTROL_PAD_xxx フラグを使用して、出力四角形の縦横比を決定します。

AMCONTROL_COLORINFO_PRESENT フラグが設定されている場合は、dwControlFlags フィールドの上位 24 ビットが DXVA_ExtendedFormat 構造体として扱われることを意味します。

dwControlFlags の詳細については、このトピックの後の「解説」セクション参照してください。

dwReserved1

このメンバーは旧バージョンとの互換性を保つために使用されます。詳細については、dwControlFlags のを参照してください。

dwReserved2

システム用に予約されています。 0 に設定する必要があります。または、接続が拒否されます。

bmiHeader

ビデオイメージビットマップの色と寸法情報を含む KS_BITMAPINFOHEADER 構造体を示します。

備考

bob または織り込み設定のないビデオストリームを記述するには、KS_VIDEOINFOHEADERを使用します。

KS_VIDEOINFOHEADER2構造体は、DirectShow VIDEOINFOHEADER2 構造体と同じです。

(フレームではなく) ビデオフィールドを生成するキャプチャミニドライバーは、KS_VIDEOINFOHEADER2構造を含む KS_DATARANGE_VIDEO2 構造体を使用する必要があります。

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

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

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

AMCONTROL_COLORINFO_PRESENT フラグが dwControlFlags メンバーで設定されている場合は、dwControlFlags 値を DXVA_ExtendedFormat 構造体にキャストして、拡張色情報にアクセスできます。詳細については、VIDEOINFOHEADER2を参照してください。

必要条件

要件	価値
ヘッダー	ksmedia.h (Ksmedia.h を含む)

次の方法で共有

KS_VIDEOINFOHEADER2構造体 (ksmedia.h)

構文

メンバーズ

備考

必要条件

関連項目

フィードバック

その他のリソース