DDVIDEOPORTCONNECT

The DDVIDEOPORTCONNECT structure describes a video port connection. This structure is used with the IDDVideoPortContainer::GetVideoPortConnectInfo method.

typedef struct _DDVIDEOPORTCONNECT{ 
    DWORD dwSize;           // Size of the DDVIDEOPORTCONNECT structure
    DWORD dwPortWidth;      // Width of the video port
    GUID  guidTypeID;       // Description of video port connection
    DWORD dwFlags;          // Connection flags
    DWORD dwReserved1;      // Reserved, set to zero.
} DDVIDEOPORTCONNECT,*LPDDVIDEOPORTCONNECT; 
 

Members

dwSize
Size of the structure, in bytes. This member must be initialized before use.
dwPortWidth
Width of the video port. This value represents the number of physical pins on the video port, not the width of a surface in memory. This member must always be set, even when the value in the guidTypeID member assumes a certain size.
guidTypeID
A GUID that describes the sync characteristics of the video port. The following port types are predefined:
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_CCIR656 Sync information is embedded in the data stream according to the CCIR656 spec.
DDVPTYPE_BROOKTREE Sync information is embedded in the data stream using the Brooktree definition.
DDVPTYPE_PHILIPS Sync information is embedded in the data stream using the Philips definition.

dwFlags
Flags describing the capabilities of the video-port connection. This member can be set by DirectDraw when connection information is being retrieved or by the client when connection information is being set. This member can be a combination of the following flags.
DDVPCONNECT_DOUBLECLOCK Indicates that the video port either supports double-clocking data or should double-clock data. This flag is only valid with an external sync.
DDVPCONNECT_VACT Indicates that the video port either supports using an external VACT signal or should use the external VACT signal. This flag is only valid with an external sync.
DDVPCONNECT_INVERTPOLARITY Indicates that the video port is capable of inverting the field polarities or is to invert field polarities.

When a video port inverts field polarities, it treats even fields as odd fields and vice versa.

DDVPCONNECT_DISCARDSVREFDATA The video port discards any data written during the VREF period, causing it to not be written to the frame buffer. This flag is read-only.
DDVPCONNECT_HALFLINE The video port will write half lines into the frame buffer, sometimes causing the data to be displayed incorrectly. This flag is read-only.
DDVPCONNECT_INTERLACED Indicates that the signal is interlaced. This flag is only used by the client when creating a video port object.
DDVPCONNECT_SHAREEVEN The physical video port is shareable, and that this video port object will use the even fields. This flag is only used by the client when creating the video port object.
DDVPCONNECT_SHAREODD The physical video port is shareable, and that this video port object will use the odd fields. This flag is only used by the client when creating the video port object.

dwReserved1
Reserved; set to zero.

Remarks

This structure is used independently and as a member of the DDVIDEOPORTDESC structure.

QuickInfo

  Windows NT: Use version 5.0 or later.
  Windows: Use Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Header: Declared in dvp.h.