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 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 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.
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.