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
指向描述 VPE 对象如何将视频数据传输到图面的 DDVIDEOPORTINFO 结构。 DDRAWI_VPORTSTOP dwFlags 时，此成员可以为 NULL。
dwFlags
指示 VPE 对象要执行的操作。 此成员必须是以下值之一：
| 标志 | 含义 |
|---|---|
| DDRAWI_VPORTSTART | 驱动程序应通过 VPE 对象启动数据流。 |
| DDRAWI_VPORTSTOP | 驱动程序应停止通过 VPE 对象的数据流。 |
| DDRAWI_VPORTUPDATE | DdVideoPortUpdate 已使用 lpVideoInfo 指向的 DDVIDEOPORTINFO 结构的 dwVPFlags 成员中的一组新标志调用。 驱动程序应根据新标志更改通过 VPE 对象的数据流。 |
dwNumAutoflip
指定列表中 lplpDDSurface 指向的图面 数。 如果此成员大于 1， 则 lplpDDSurface 是用于适应自动翻转的图面结构的数组。
dwNumVBIAutoflip
指定列表中 lplpDDVBISurface 指向的图面 数。 如果此成员大于 1， 则 lplpDDVBISurface 是表面结构的数组，用于适应 VBI 数据的自动翻转。
ddRVal
指定驱动程序写入 DdVideoPortUpdate 回调的返回值的位置。 返回代码DD_OK表示成功。 有关详细信息，请参阅 DirectDraw 的返回值。
UpdateVideoPort
由 DirectDraw API 使用，驱动程序不应填充。
要求
| 要求 | 值 |
|---|---|
| Header | ddrawint.h (包括 Winddi.h) |