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)

另請參閱

DdVideoPortCanCreate

DdVideoPortGetConnectInfo