DDVIDEOPORTCONNECT structure (ksmedia.h)

  • Article

The DDVIDEOPORTCONNECT structure describes a hardware video port connection.

Syntax

typedef struct _DDVIDEOPORTCONNECT {
  DWORD     dwSize;
  DWORD     dwPortWidth;
  GUID      guidTypeID;
  DWORD     dwFlags;
  ULONG_PTR dwReserved1;
} DDVIDEOPORTCONNECT, *LPDDVIDEOPORTCONNECT;

Members

dwSize

Specifies the size in bytes of the DDVIDEOPORTCONNECT structure.

dwPortWidth

Specifies the width of the hardware video port. This value represents the number of physical pins on the hardware video port. This member must always be filled in, even when the guidTypeID assumes a certain size.

guidTypeID

Specifies a GUID that describes the synchronization characteristics of the hardware video port. The following port types are predefined:

Port Type Description
DDVPTYPE_E_HREFH_VREFH External syncs where HREF is active high and VREF is active high.
DDVPTYPE_E_HREFH_VREFL External syncs where HREF is active high and VREF is active low.
DDVPTYPE_E_HREFL_VREFH External syncs where HREF is active low and VREF is active high.
DDVPTYPE_E_HREFL_VREFL External syncs where HREF is active low and VREF is active low.
DDVPTYPE_BROOKTREE Sync information is embedded in the data stream using the Brooktree definition.
DDVPTYPE_CCIR656 Sync information is embedded in the data stream according to the CCIR656 specification.
DDVPTYPE_PHILIPS Sync information is embedded in the data stream using the Philips definition.

dwFlags

Specifies a set of flags that identify the capabilities of the hardware video port connection. This member can be a bitwise OR of any of the following flags:

Flag Meaning
DDVPCONNECT_DISCARDSVREFDATA The device discards any data written during the VREF period, causing this data to not be written to the frame buffer. This flag should be set only by the driver.
DDVPCONNECT_DOUBLECLOCK When set by the driver, this flag indicates that the hardware video port is capable of double clocking the data. When set by the client, it indicates that the hardware video port should double clock the data. This flag is valid only in a hardware video port with a guidTypeID that supports an external sync.
DDVPCONNECT_HALFLINE When set by the driver, this flag indicates that the hardware video port supports writing half lines into the frame buffer, sometimes causing the data to not be displayed correctly. When set by the client, it indicates that the driver may write half lines.
DDVPCONNECT_INTERLACED When set by the driver, this flag indicates that the hardware video port supports interlaced signals. When set by the client, it indicates that the signal is interlaced.
DDVPCONNECT_INVERTPOLARITY When set by the driver, this flag indicates that the hardware video port is capable of inverting the field polarities; that is, treating even fields as odd and vice versa. When set by the client, it indicates that the hardware video port should invert the field polarities.
DDVPCONNECT_SHAREEVEN This is currently an unimplemented feature and should be ignored by the driver.
DDVPCONNECT_SHAREODD This is currently an unimplemented feature and should be ignored by the driver.
DDVPCONNECT_VACT When set by the driver, this flag indicates that the hardware video port is capable of using an external VACT signal. When set by the client, it indicates that the hardware video port should use the external VACT signal.

dwReserved1

Reserved for system use and should be set to zero.

Remarks

The driver's DdVideoPortGetConnectInfo callback routine initializes a DDVIDEOPORTCONNECT structure for every connection that the hardware video port supports. The client can change the dwFlags member of one of the driver's DDVIDEOPORTCONNECT structures before calling the driver's DdVideoPortCanCreate callback.

Requirements

Requirement Value
Header ksmedia.h (include Dvp.h)

See also

DdVideoPortCanCreate

DdVideoPortGetConnectInfo