DirectX SDK

DDVIDEOPORTCONNECT

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

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

Members

dwSize

Size of the structure, in bytes. This member must be initialized before the structure is used.

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 specification.
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: The video port either supports double-clocking data or should double-clock data. This flag is only valid with an external sync.
DDVPCONNECT_VACT: 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: 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; it is not written to the frame buffer. This flag is read-only.
DDVPCONNECT_HALFLINE: The video port writes half lines into the frame buffer, sometimes causing the data to be displayed incorrectly. This flag is read-only.
DDVPCONNECT_INTERLACED: The signal is interlaced. This flag is used by the client only when creating a video port object.
DDVPCONNECT_SHAREEVEN: The physical video port is sharable, and this video-port object uses the even fields. This flag is used by the client only when creating the video-port object.
DDVPCONNECT_SHAREODD: The physical video port is sharable, and this video-port object uses the odd fields. This flag is used by the client only when creating the video-port object.

dwReserved1

Reserved; set to 0.

Remarks

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

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in dvp.h.