DDVIDEOPORTCONNECT structure (ksmedia.h)
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) |