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 を含む) |