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。
要求
要求 | 价值 |
---|---|
标头 | ksmedia.h (包括 Dvp.h) |