PDD_VPORTCB_UPDATE回呼函式 (ddrawint.h)

DdVideoPortUpdate回呼函式會啟動和停止 VPE 物件，並修改 VPE 物件資料流程。

語法

PDD_VPORTCB_UPDATE PddVportcbUpdate;

DWORD PddVportcbUpdate(
  PDD_UPDATEVPORTDATA unnamedParam1
)
{...}

參數

unnamedParam1

指向包含驅動程式更新 VPE 物件所需資訊的 DD_UPDATEVPORTDATA 結構。

傳回值

DdVideoPortUpdate 會傳回下列其中一個回呼代碼：

備註

支援 VPE 的 DirectDraw 驅動程式必須實作 DdVideoPortUpdate。

當lpUpdate DD_UPDATEVPORTDATA 結構的dwFlags成員DDRAWI_VPORTSTART或DDRAWI_VPORTUPDATE時，驅動程式應該執行下列動作：

• 檢查DDVIDEOPORTINFO結構的dwVPFlags成員中的所有旗標，其中lpVideoInfo成員DD_UPDATEVPORTDATA點。 這些旗標描述驅動程式如何將視訊資料傳輸至介面 (或表面) ;例如，它們會指出驅動程式是否應該執行自動滑動、裁剪視訊或 VBI 資料等等。
• 在硬體中設定迴圈，以將視訊和/或 VBI 資料寫入介面的順序，讓表面儲存在陣列中 () 。 設定這些迴圈之後，驅動程式應該儘快傳回。
• 如果已要求自動剪貼，請將每個表面的畫面緩衝區位移儲存在驅動程式的內部資料結構中。 表面位移應該以DD_UPDATEVPORTDATA的 lplpDDDSurface 和 lplpDDVBISurface成員DD_SURFACE_INT陣列發生的順序儲存。 如此一來，當 呼叫 DdUpdateOverlay 時，驅動程式會記錄表面鏈結的翻轉順序。

如果驅動程式的硬體無法支援要求自動剪貼時指定的表面數目， DdVideoPortUpdate 應該會在 DD_UPDATEVPORTDATA 的 ddRVal 成員中設定DDERR_UNSUPPORTED來失敗呼叫。

視訊和 VBI 表面鏈結中的表面數目可能不同;也就是說，DD_UPDATEVPORTDATA的 dwNumAutoflip 和 dwNumVBIAutoflip 成員可以是不同的值。

當 dwFlags DDRAWI_VPORTSTOP時，驅動程式應該會立即傳回。 在資料流程停止之前，驅動程式不應該輪詢。

需求

另請參閱

DDVIDEOPORTINFO

DD_SURFACE_INT

DD_UPDATEVPORTDATA

DdUpdateOverlay