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 がアクティブで Low、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 | ドライバーによって設定された場合、このフラグは、ハードウェア ビデオ ポートがフレーム バッファーへの半行の書き込みをサポートしていることを示します。これにより、データが正しく表示されないことがあります。 クライアントによって設定されると、ドライバーが半行を書き込む可能性があることを示します。 |
| DDVPCONNECT_INTERLACED | ドライバーによって設定された場合、このフラグは、ハードウェア ビデオ ポートがインターレース信号をサポートしていることを示します。 クライアントによって設定されると、シグナルがインターレースされていることを示します。 |
| DDVPCONNECT_INVERTPOLARITY | ドライバーによって設定された場合、このフラグは、ハードウェア ビデオ ポートがフィールドの極性を反転できることを示します。つまり、偶数フィールドを奇数として扱い、その逆の扱いを行います。 クライアントによって設定されると、ハードウェア ビデオ ポートがフィールドの極性を反転する必要があることを示します。 |
| DDVPCONNECT_SHAREEVEN | これは現在、実装されていない機能であり、ドライバーでは無視する必要があります。 |
| DDVPCONNECT_SHAREODD | これは現在、実装されていない機能であり、ドライバーでは無視する必要があります。 |
| DDVPCONNECT_VACT | ドライバーによって設定された場合、このフラグは、ハードウェア ビデオ ポートが外部 VACT 信号を使用できることを示します。 クライアントによって設定されると、ハードウェア ビデオ ポートが外部 VACT 信号を使用する必要があることを示します。 |
dwReserved1
システム用に予約されており、0 に設定する必要があります。
備考
ドライバーの DdVideoPortGetConnectInfo コールバック ルーチンは、ハードウェア ビデオ ポートがサポートするすべての接続の DDVIDEOPORTCONNECT 構造体を初期化します。 クライアントは、ドライバーの DdVideoPortCanCreate コールバックを呼び出す前に、ドライバーの DDVIDEOPORTCONNECT 構造体のメンバー dwFlags を変更できます。
必要条件
| 要件 | 価値 |
|---|---|
| ヘッダー | ksmedia.h (Dvp.h を含む) |
関連項目
DdVideoPortCanCreate の
DdVideoPortGetConnectInfo の