DDVIDEOPORTCONNECT 結構 (ksmedia.h)
DDVIDEOPORTCONNECT 結構描述硬體視訊埠連線。
語法
typedef struct _DDVIDEOPORTCONNECT {
DWORD dwSize;
DWORD dwPortWidth;
GUID guidTypeID;
DWORD dwFlags;
ULONG_PTR dwReserved1;
} DDVIDEOPORTCONNECT, *LPDDVIDEOPORTCONNECT;
成員
dwSize
以位元組為單位指定 DDVIDEOPORTCONNECT 結構的大小。
dwPortWidth
指定硬體視訊埠的寬度。 這個值代表硬體視訊埠上的實體針腳數目。 即使 guidTypeID 假設有特定大小，此成員也必須一律填入。
guidTypeID
指定 GUID，描述硬體視訊埠的同步處理特性。 下列埠類型是預先定義的：
| 連接埠類型 | Description |
|---|---|
| DDVPTYPE_E_HREFH_VREFH | HREF 為高作用中且 VREF 為高作用中的外部同步處理。 |
| DDVPTYPE_E_HREFH_VREFL | HREF 為高作用中且 VREF 為低作用中的外部同步處理。 |
| DDVPTYPE_E_HREFL_VREFH | HREF 為低作用中且 VREF 為高作用中的外部同步處理。 |
| DDVPTYPE_E_HREFL_VREFL | HREF 為低作用中且 VREF 為低作用中的外部同步處理。 |
| DDVPTYPE_BROOKTREE | 同步處理資訊會內嵌在數據流中，使用 Tree 定義。 |
| DDVPTYPE_CCIR656 | 同步處理資訊會根據CCIR656規格內嵌在數據流中。 |
| DDVPTYPE_PHILIPS | 同步處理資訊會內嵌在數據流中使用 Philips 定義。 |
dwFlags
指定一組旗標，識別硬體視訊埠連線的功能。 此成員可以是下列任一旗標的位 OR：
| 旗標 | 意義 |
|---|---|
| DDVPCONNECT_DISCARDSVREFDATA | 裝置會捨棄 VREF 期間寫入的任何數據，導致此數據不會寫入框架緩衝區。 此旗標只能由驅動程序設定。 |
| DDVPCONNECT_DOUBLECLOCK | 由驅動程式設定時，此旗標表示硬體視訊埠能夠重複時鐘數據。 用戶端設定時，表示硬體視訊埠應該重複時鐘數據。 此旗標只在支援外部同步處理的硬體視訊埠中使用 guidTypeID 有效。 |
| DDVPCONNECT_HALFLINE | 由驅動程式設定時，此旗標表示硬體視訊埠支援將半行寫入框架緩衝區，有時導致數據無法正確顯示。 由客戶端設定時，表示驅動程式可能會寫入半行。 |
| DDVPCONNECT_INTERLACED | 由驅動程式設定時，此旗標表示硬體視訊埠支援交錯訊號。 由客戶端設定時，表示訊號交錯。 |
| DDVPCONNECT_INVERTPOLARITY | 由驅動程式設定時，此旗標表示硬體視訊埠能夠反轉欄位極性;也就是說，將偶數位段視為奇數，反之亦然。 客戶端設定時，表示硬體視訊埠應該反轉欄位極性。 |
| DDVPCONNECT_SHAREEVEN | 這是目前未實作的功能，驅動程序應該予以忽略。 |
| DDVPCONNECT_SHAREODD | 這是目前未實作的功能，驅動程序應該予以忽略。 |
| DDVPCONNECT_VACT | 由驅動程式設定時，此旗標表示硬體視訊埠能夠使用外部 VACT 訊號。 用戶端設定時，表示硬體視訊埠應該使用外部 VACT 訊號。 |
dwReserved1
保留供系統使用，且應設定為零。
備註
驅動程式的 DdVideoPortGetConnectInfo 回呼例程會針對硬體視訊埠支援的每個連線，初始化 DDVIDEOPORTCONNECT 結構。 用戶端可以在呼叫驅動程式的 DdVideoPortCanCreate 回呼之前，先變更其中一個驅動程式 DDVIDEOPORTCONNECT 結構的 dwFlags 成員。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | ksmedia.h (包含 Dvp.h) |