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)

另请参阅

DDVIDEOPORTINFO

DdVideoPortUpdate