DD_UPDATEVPORTDATA 結構 (ddrawint.h)
DD_UPDATEVPORTDATA 結構包含啟動、停止和變更 VPE) 物件 (視訊埠延伸 模組所需的資訊。
語法
typedef struct _DD_UPDATEVPORTDATA {
PDD_DIRECTDRAW_LOCAL lpDD;
PDD_VIDEOPORT_LOCAL lpVideoPort;
PDD_SURFACE_INT *lplpDDSurface;
PDD_SURFACE_INT *lplpDDVBISurface;
PDD_VIDEOPORTINFO lpVideoInfo;
DWORD dwFlags;
DWORD dwNumAutoflip;
DWORD dwNumVBIAutoflip;
HRESULT ddRVal;
VOID *UpdateVideoPort;
} *PDD_UPDATEVPORTDATA, DD_UPDATEVPORTDATA;
成員
lpDD
指向與目前 Microsoft DirectDraw 程式相關的 DD_DIRECTDRAW_LOCAL 結構。
lpVideoPort
指向代表這個 VPE 物件的 DD_VIDEOPORT_LOCAL 結構。
lplpDDSurface
指向代表一般視訊表面 的DD_SURFACE_INT 結構陣列。 這個成員可以是 NULL。
lplpDDVBISurface
指向代表 VBI 表面的DD_SURFACE_INT結構陣列。 這個成員可以是 NULL。
lpVideoInfo
指向 DDVIDEOPORTINFO 結構，描述 VPE 物件如何將視訊數據傳送至表面。 當 dwFlags DDRAWI_VPORTSTOP時，這個成員可以是 NULL。
dwFlags
指出 VPE 物件所要執行的動作。 這個成員必須是下列其中一個值：
| 旗標 | 意義 |
|---|---|
| DDRAWI_VPORTSTART | 驅動程式應該會透過 VPE 物件啟動資料流。 |
| DDRAWI_VPORTSTOP | 驅動程式應該會透過 VPE 物件停止資料流。 |
| DDRAWI_VPORTUPDATE | DdVideoPortUpdate 已使用 DDVIDEOPORTINFO 結構的 dwVPFlags 成員中的一組新旗標呼叫， lpVideoInfo 會指向該結構。 驅動程式應該根據新的旗標，透過 VPE 物件變更數據流。 |
dwNumAutoflip
指定 清單中 lplpDDSurface 指向的介面數目。 如果這個成員大於 1，lplpDDSurface 是介面結構的陣列，可容納自動滑動。
dwNumVBIAutoflip
指定 清單中 lplpDDVBISurface 點數的介面數目。 如果這個成員大於 1，lplpDDVBISurface 是介面結構的數位，可容納 VBI 數據的自動滑動。
ddRVal
指定驅動程式寫入 DdVideoPortUpdate 回呼傳回值的位置。 DD_OK的傳回碼表示成功。 如需詳細資訊，請參閱 DirectDraw 的傳回值。
UpdateVideoPort
由 DirectDraw API 使用，且不應該由驅動程式填入。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | ddrawint.h (包括 Winddi.h) |