Expand Minimize

DDVIDEOPORTCONNECT structure

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;

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 TypeDescription

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:

FlagMeaning

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

Header

Dvp.h (include Dvp.h)

See also

DdVideoPortCanCreate
DdVideoPortGetConnectInfo

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft