DDVIDEOPORTCONNECT 構造体 (ksmedia.h)

DDVIDEOPORTCONNECT 構造体では、ハードウェア ビデオ ポート接続について説明します。

構文

typedef struct _DDVIDEOPORTCONNECT {
  DWORD     dwSize;
  DWORD     dwPortWidth;
  GUID      guidTypeID;
  DWORD     dwFlags;
  ULONG_PTR dwReserved1;
} DDVIDEOPORTCONNECT, *LPDDVIDEOPORTCONNECT;

メンバー

dwSize

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

dwPortWidth

ハードウェア ビデオ ポートの幅を指定します。 この値は、ハードウェア ビデオ ポート上の物理ピンの数を表します。 guidTypeID が特定のサイズを想定している場合でも、このメンバーは常に入力する必要があります。

guidTypeID

ハードウェア ビデオ ポートの同期特性を記述する GUID を指定します。 次のポートの種類が事前に定義されています。

ポートの種類	説明
DDVPTYPE_E_HREFH_VREFH	HREF がアクティブハイで、VREF がアクティブハイの外部同期。
DDVPTYPE_E_HREFH_VREFL	HREF がアクティブハイ、VREF がアクティブローの外部同期。
DDVPTYPE_E_HREFL_VREFH	HREF がアクティブローで、VREF がアクティブハイの外部同期。
DDVPTYPE_E_HREFL_VREFL	HREF がアクティブロー、VREF がアクティブローの外部同期。
DDVPTYPE_BROOKTREE	同期情報は、ブルックツリー定義を使用してデータ ストリームに埋め込まれます。
DDVPTYPE_CCIR656	同期情報は、CCIR656仕様に従ってデータ ストリームに埋め込まれます。
DDVPTYPE_PHILIPS	同期情報は、Philips 定義を使用してデータ ストリームに埋め込まれます。

dwFlags

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

フラグ	説明
DDVPCONNECT_DISCARDSVREFDATA	デバイスは VREF 期間中に書き込まれたデータを破棄するため、このデータはフレーム バッファーに書き込まれません。 このフラグは、ドライバーによってのみ設定する必要があります。
DDVPCONNECT_DOUBLECLOCK	ドライバーによって設定されると、このフラグは、ハードウェア ビデオ ポートがデータを 2 回クロッキングできることを示します。 クライアントによって設定されると、ハードウェア ビデオ ポートがデータを 2 回クロックする必要があることを示します。 このフラグは、外部同期をサポートする guidTypeID を持つハードウェア ビデオ ポートでのみ有効です。
DDVPCONNECT_HALFLINE	ドライバーによって設定された場合、このフラグは、ハードウェア ビデオ ポートがフレーム バッファーへの半行の書き込みをサポートしていることを示します。これにより、データが正しく表示されないことがあります。 クライアントによって設定されると、ドライバーが 5 行を書き込む可能性があることを示します。
DDVPCONNECT_INTERLACED	ドライバーによって設定された場合、このフラグは、ハードウェア ビデオ ポートがインターレース信号をサポートしていることを示します。 クライアントによって設定されると、シグナルがインターレースされることを示します。
DDVPCONNECT_INVERTPOLARITY	ドライバーによって設定された場合、このフラグは、ハードウェア ビデオ ポートがフィールドの極性を反転できることを示します。つまり、偶数フィールドを奇数として扱い、その逆も同様です。 クライアントによって設定されると、ハードウェア ビデオ ポートがフィールドの極性を反転する必要があることを示します。
DDVPCONNECT_SHAREEVEN	これは現在、実装されていない機能であり、ドライバーでは無視する必要があります。
DDVPCONNECT_SHAREODD	これは現在、実装されていない機能であり、ドライバーでは無視する必要があります。
DDVPCONNECT_VACT	ドライバーによって設定されると、このフラグは、ハードウェア ビデオ ポートが外部 VACT 信号を使用できることを示します。 クライアントによって設定されると、ハードウェア ビデオ ポートで外部 VACT 信号を使用する必要があることを示します。

dwReserved1

システム用に予約されており、0 に設定する必要があります。

注釈

ドライバーの DdVideoPortGetConnectInfo コールバック ルーチンは、ハードウェア ビデオ ポートがサポートするすべての接続に対して DDVIDEOPORTCONNECT 構造体を初期化します。 クライアントは、ドライバーの DdVideoPortCanCreate コールバックを呼び出す前に、ドライバーの DDVIDEOPORTCONNECT 構造体の dwFlags メンバーを変更できます。

要件

要件	値
Header	ksmedia.h (Dvp.h を含む)

こちらもご覧ください

DdVideoPortCanCreate

DdVideoPortGetConnectInfo