DDVIDEOPORTCAPS 構造体 (dvp.h)

[アーティクル]
08/23/2023

DDVIDEOPORTCAPS 構造体では、ハードウェアビデオポートの機能とアラインメントの制限について説明します。

構文

typedef struct _DDVIDEOPORTCAPS {
  DWORD dwSize;
  DWORD dwFlags;
  DWORD dwMaxWidth;
  DWORD dwMaxVBIWidth;
  DWORD dwMaxHeight;
  DWORD dwVideoPortID;
  DWORD dwCaps;
  DWORD dwFX;
  DWORD dwNumAutoFlipSurfaces;
  DWORD dwAlignVideoPortBoundary;
  DWORD dwAlignVideoPortPrescaleWidth;
  DWORD dwAlignVideoPortCropBoundary;
  DWORD dwAlignVideoPortCropWidth;
  DWORD dwPreshrinkXStep;
  DWORD dwPreshrinkYStep;
  DWORD dwNumVBIAutoFlipSurfaces;
  DWORD dwNumPreferredAutoflip;
  WORD  wNumFilterTapsX;
  WORD  wNumFilterTapsY;
} *LPDDVIDEOPORTCAPS, DDVIDEOPORTCAPS;

メンバー

dwSize

構造体のサイズをバイト単位で指定します。

dwFlags

この構造体内の有効なデータを含むメンバーを指定します。このメンバーには、次のいずれかの値のビットごとの OR を指定できます。

フラグ	説明
DDVPD_ALIGN	すべてのアラインメントメンバーが有効です。次に例を示します。 dwAlignVideoPortBoundary、 dwAlignVideoPortPrescaleWidth、 dwAlignVideoPortCropBoundary、および dwAlignVideoPortCropWidth。
DDVPD_AUTOFLIP	dwNumAutoFlipSurfaces は有効です。
DDVPD_CAPS	dwCaps メンバーは有効です。
DDVPD_FX	dwFX メンバーは有効です。
DDVPD_HEIGHT	dwMaxHeight メンバーは有効です。
DDVPD_ID	dwVideoPortID メンバーは有効です。
DDVPD_WIDTH	dwMaxWidth メンバーと dwMaxVBIWidth メンバーは有効です。

dwMaxWidth

ハードウェアビデオポートでサポートされる最大フィールド幅をピクセル単位で指定します。この値は通常、幅レジスタのビット数によって決まります。

dwMaxVBIWidth

ハードウェアビデオポートでサポートされている VBI データの行の最大幅をサンプル数で指定します。ハードウェアビデオポートでオーバーサンプリングされた VBI データがサポートされている場合、この値は通常のフィールド幅よりも大きくなる可能性があります。

dwMaxHeight

ハードウェアビデオポートでサポートされる最大フィールドの高さをピクセル単位で指定します。この値は通常、高さレジスタのビット数によって決まります。

dwVideoPortID

このエントリのハードウェアビデオポート ID を指定します。このメンバーは、DD_DIRECTDRAW_GLOBAL構造体の lpDDVideoPortCaps メンバーがポイントする配列内のこの DDVIDEOPORTCAPS 構造体のインデックス番号である必要があります。この値の範囲は 0 から (dwMaxVideoPorts - 1) です。 (dwMaxVideoPorts は DDCORECAPS 構造体のメンバーです)。デバイスが 1 つのハードウェアビデオポートのみをサポートしている場合、このメンバーは 0 である必要があります。

dwCaps

このハードウェアビデオポートでサポートされる機能を指定するフラグのセットを示します。このメンバーには、次のいずれかの値のビットごとの OR を指定できます。

フラグ	説明
DDVPCAPS_AUTOFLIP	切り裂きを避けるために、フリップを自動的に実行できます。
DDVPCAPS_COLORCONTROL	ハードウェアビデオポートは、フレームバッファーに書き込まれる前に、受信データに対してカラー操作を実行できます。
DDVPCAPS_INTERLACED	ハードウェアビデオポートでは、インターレースされたビデオがサポートされます。
DDVPCAPS_NONINTERLACED	ハードウェアビデオポートは、インターレースされていないビデオをサポートしています。
DDVPCAPS_OVERSAMPLEDVBI	ハードウェアビデオポートは、通常のビデオデータとは異なる幅または形式の VBI データを受け入れます。
DDVPCAPS_READBACKFIELD	デバイスは、インターレース信号の現在のフィールドが偶数か奇数かを示す値を返すことができます。
DDVPCAPS_READBACKLINE	デバイスは、フレームバッファーに書き込まれているビデオの現在の行の数を返すことができます。
DDVPCAPS_SHAREABLE	Microsoft DirectDraw によって無視されます。
DDVPCAPS_SKIPEVENFIELDS	ハードウェアビデオポートは、ビデオの偶数フィールドを自動的に破棄できます。
DDVPCAPS_SKIPODDFIELDS	ハードウェアビデオポートは、ビデオの奇数フィールドを自動的に破棄できます。
DDVPCAPS_SYNCMASTER	このデバイスは、ハードウェアビデオポートドライバー V 同期を使用してグラフィックス V 同期を駆動できます。
DDVPCAPS_SYSTEMMEMORY	ハードウェアビデオポートは、システムメモリにデータを直接書き込むことができます。
DDVPCAPS_VBISURFACE	垂直ブランキング間隔内のデータは、別のサーフェスに書き込むことができます。

dwFX

このハードウェアビデオポートでサポートされる効果を指定するフラグのセットを示します。このメンバーは、次のいずれかの値のビットごとの OR です。

フラグ	説明
DDVPFX_CROPTOPDATA	ハードウェアビデオポートでは、垂直方向の間隔データをトリミングするための制限付きトリミングがサポートされています。
DDVPFX_CROPX	ハードウェアビデオポートでは、入力データを x 方向にトリミングしてからサーフェスに書き込むことができます。
DDVPFX_CROPY	ハードウェアビデオポートでは、受信データをサーフェスに書き込む前に y 方向にトリミングできます。
DDVPFX_IGNOREVBIXCROP	ハードウェアビデオポートは、オーバーサンプリングされた VBI データをトリミングするときに、ビデオデータの左右のトリミング座標を無視できます。
DDVPFX_INTERLEAVE	ハードウェアビデオポートでは、メモリ内のインターレースされたフィールドのインターリーブがサポートされています。
DDVPFX_MIRRORLEFTRIGHT	ハードウェアビデオポートでは、ビデオデータがフレームバッファーに書き込まれるので、左から右へのミラーリングがサポートされます。
DDVPFX_MIRRORUPDOWN	ハードウェアビデオポートは、ビデオデータがフレームバッファーに書き込まれるので、上から下へのミラーリングをサポートします。
DDVPFX_PRESHRINKX	データは、サーフェスに書き込まれる前に x 方向に任意に縮小できます。
DDVPFX_PRESHRINKXB	データは、表面に書き込まれる前に、x 方向に 2 (1/2、1/4、1/8 など) の負の累乗で縮小できます。
DDVPFX_PRESHRINKXS	データは、サーフェスに書き込まれる前に x 方向に 1/dwPreshrinkXStep ずつ縮小できます。
DDVPFX_PRESHRINKY	データは、サーフェスに書き込まれる前に、y 方向に任意に縮小できます。
DDVPFX_PRESHRINKYB	データは、表面に書き込まれる前に、y 方向に 2 (1/2、1/4、1/8 など) の負の力で縮小できます。
DDVPFX_PRESHRINKYS	データは、サーフェスに書き込まれる前に、y 方向に 1/dwPreshrinkYStep の増分で圧縮できます。
DDVPFX_PRESTRETCHX	データは、サーフェスに書き込まれる前に x 方向に任意にストレッチできます。
DDVPFX_PRESTRETCHXN	データは、サーフェスに書き込まれる前に、x 方向の整数要素によって引き伸ばすことができます。
DDVPFX_PRESTRETCHY	データは、サーフェスに書き込まれる前に、y 方向に任意にストレッチできます。
DDVPFX_PRESTRETCHYN	データは、サーフェスに書き込まれる前に、y 方向の整数要素によって引き伸ばすことができます。
DDVPFX_VBICONVERT	垂直ブランキング間隔内のデータは、残りのビデオデータとは無関係に変換できます。
DDVPFX_VBINOSCALE	垂直方向の空白間隔内のデータに対してスケーリングを無効にすることができます。

dwNumAutoFlipSurfaces

ハードウェアビデオポートでオートフリップがサポートされている場合に、オートフラグチェーンでサポートされるサーフェスの最大数を指定します。ハードウェアビデオポートで自動フラグがサポートされていない場合、ドライバーはこのメンバーを 0 に設定する必要があります。

dwAlignVideoPortBoundary

ハードウェアビデオポートを x 方向のサーフェスの原点に対して相対的に配置できるバイトアラインメント制限をバイト単位で指定します。

dwAlignVideoPortPrescaleWidth

事前スケーリングの実行時にハードウェアビデオポートデータの幅をバイト単位で指定します。

dwAlignVideoPortCropBoundary

左トリミング座標のバイト配置制限をバイト単位で指定します。

dwAlignVideoPortCropWidth

トリミングする四角形の幅に対するバイト配置制限をバイト単位で指定します。

dwPreshrinkXStep

ハードウェアビデオポートが 1/dwPreshrinkXStep の手順でビデオデータ幅を縮小できることを示します。このメンバーは、DDVPFX_PRESHRINKXS機能が指定されている場合にのみ有効です。

dwPreshrinkYStep

ハードウェアビデオポートが 1/dwPreshrinkYStep の手順でビデオデータの高さを縮小できることを示します。このメンバーは、DDVPFX_PRESHRINKYS機能が指定されている場合にのみ有効です。

dwNumVBIAutoFlipSurfaces

ハードウェアビデオポートでオートフリップがサポートされている場合に、オートフラグチェーンでサポートされるサーフェスの最大数を指定します。ハードウェアビデオポートで自動フラグがサポートされていない場合、ドライバーはこのメンバーを 0 に設定する必要があります。このメンバーは dwNumAutoFlipSurfaces と同じように動作しますが、VBI データを通常のビデオの書き込み先とは異なるサーフェスに送信できるデバイスにのみ関係する点が異なります。

dwNumPreferredAutoflip

ハードウェアでサポートされるオートフリップ可能なサーフェスの最適な数を指定します。

wNumFilterTapsX

プレスケーラーが x 方向に使用するタップの数を示します。値 0 は、事前スケーリングがないことを示し、値 1 はレプリケーションを示します。

wNumFilterTapsY

プリスケーラーが y 方向に使用するタップの数を示します。値 0 は、事前スケーリングがないことを示し、値 1 はレプリケーションを示します。

解説

ドライバーは、 DDGetDriverInfo 関数が GUID_VideoPortCaps GUID を使用して呼び出されたときに、DDVIDEOPORTCAPS 構造体によって記述された機能を報告します。

要件


Header	dvp.h (Dvp.h を含む)

次の方法で共有

DDVIDEOPORTCAPS 構造体 (dvp.h)

構文

メンバー

解説

要件

関連項目

フィードバック

その他のリソース