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)

另请参阅

DdVideoPortCanCreate

DdVideoPortGetConnectInfo