共用方式為


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,描述硬體視訊埠的同步處理特性。 下列埠型態已預先定義:

埠類型 描述
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 同步資訊會內嵌在數據流中使用 Brooktree 定義。
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