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 | 同步信息使用 Brooktree 定义嵌入到数据流中。 |
| DDVPTYPE_CCIR656 | 根据CCIR656规范，同步信息嵌入到数据流中。 |
| DDVPTYPE_PHILIPS | 使用 Philips 定义将同步信息嵌入到数据流中。 |
dwFlags
指定一组标志，用于标识硬件视频端口连接的功能。 此成员可以是以下任何标志的按位 OR：
| 标志 | 含义 |
|---|---|
| DDVPCONNECT_DISCARDSVREFDATA | 设备放弃在 VREF 期间写入的任何数据，导致此数据不写入帧缓冲区。 此标志只能由驱动程序设置。 |
| DDVPCONNECT_DOUBLECLOCK | 当驱动程序设置时，此标志指示硬件视频端口能够对数据进行双重计时。 当由客户端设置时，它指示硬件视频端口应使数据加倍时钟。 此标志仅在支持外部同步的 guidTypeID 的硬件视频端口中有效。 |
| DDVPCONNECT_HALFLINE | 当驱动程序设置时，此标志指示硬件视频端口支持将半行写入帧缓冲区，有时会导致数据无法正确显示。 当客户端设置时，它指示驱动程序可以写入半行。 |
| DDVPCONNECT_INTERLACED | 当驱动程序设置时，此标志指示硬件视频端口支持交错信号。 当客户端设置时，它指示信号是交错的。 |
| DDVPCONNECT_INVERTPOLARITY | 当驱动程序设置时，此标志指示硬件视频端口能够反转场极性;也就是说，将偶数字段视为奇数字段，反之亦然。 当客户端设置时，它指示硬件视频端口应反转场极性。 |
| DDVPCONNECT_SHAREEVEN | 这是目前未实现的功能，驱动程序应忽略此功能。 |
| DDVPCONNECT_SHAREODD | 这是目前未实现的功能，驱动程序应忽略此功能。 |
| DDVPCONNECT_VACT | 当驱动程序设置时，此标志指示硬件视频端口能够使用外部 VACT 信号。 当客户端设置时，它指示硬件视频端口应使用外部 VACT 信号。 |
dwReserved1
保留供系统使用，应设置为零。
注解
驱动程序的 DdVideoPortGetConnectInfo 回调例程为硬件视频端口支持的每个连接初始化 DDVIDEOPORTCONNECT 结构。 在调用驱动程序的 DdVideoPortCanCreate 回调之前，客户端可以更改驱动程序的 DDVIDEOPORTCONNECT 结构之一的 dwFlags 成员。
要求
| 要求 | 值 |
|---|---|
| Header | ksmedia.h (包括 Dvp.h) |