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)

另请参阅

DdVideoPortCanCreate

DdVideoPortGetConnectInfo