(ddrawint.h) DD_UPDATEOVERLAYDATA 结构

DD_UPDATEOVERLAYDATA结构包含更新覆盖图面所需的信息。

语法

typedef struct _DD_UPDATEOVERLAYDATA {
  PDD_DIRECTDRAW_GLOBAL lpDD;
  PDD_SURFACE_LOCAL     lpDDDestSurface;
  RECTL                 rDest;
  PDD_SURFACE_LOCAL     lpDDSrcSurface;
  RECTL                 rSrc;
  DWORD                 dwFlags;
  DDOVERLAYFX           overlayFX;
  HRESULT               ddRVal;
  VOID                  *UpdateOverlay;
} *PDD_UPDATEOVERLAYDATA, DD_UPDATEOVERLAYDATA;

成员

lpDD

指向描述驱动程序设备的 DD_DIRECTDRAW_GLOBAL 结构。

lpDDDestSurface

指向表示要叠加的 Microsoft DirectDraw 图面的 DD_SURFACE_LOCAL 结构。 如果在 dwFlags 中指定了DDOVER_HIDE，则此值可以为 NULL。

rDest

指定包含目标图面上要叠加的区域的 x、y、宽度和高度的 RECTL 结构。

lpDDSrcSurface

指向描述覆盖图面的DD_SURFACE_LOCAL结构。

rSrc

指定 RECTL 结构，该结构包含源图面上要用于覆盖的区域的 x、y、宽度和高度。

dwFlags

指定驱动程序应如何处理覆盖。 此成员可以是以下任何标志的组合：

标志	含义
DDOVER_ADDDIRTYRECT	驱动程序应忽略。
DDOVER_AUTOFLIP	每当硬件视频端口自动剪辑时，驱动程序应自动翻转覆盖层。 支持视频端口扩展 (VPE) 的驱动程序只需检查此标志。
DDOVER_BOB	驱动程序应单独显示 VPE 对象数据的每个字段，而不会导致任何抖动项目。 此标志适用于希望使用内核模式视频传输功能在内核模式下进行自己的翻转的 VPE 和解码器。
DDOVER_BOBHARDWARE	指示 bob 由硬件执行，而不是由软件或仿真执行。 支持 VPE 的驱动程序只需检查此标志。
DDOVER_DDFX	驱动程序应使用 overlayFX 成员指定的属性显示覆盖图面。
DDOVER_HIDE	驱动程序应隐藏覆盖层;也就是说，驱动程序应关闭此覆盖。
DDOVER_INTERLEAVED	覆盖图面由交错字段组成。 支持 VPE 的驱动程序只需检查此标志。
DDOVER_KEYDEST	驱动程序应使用与目标图面关联的颜色键。
DDOVER_KEYDESTOVERRIDE	驱动程序应使用 DirectDraw SDK 文档中介绍的 DDOVERLAYFX 结构的 dckDestColorKey 成员， () 作为目标颜色键，而不是与目标图面关联的颜色键。
DDOVER_KEYSRC	驱动程序应使用与目标图面关联的颜色键。
DDOVER_KEYSRCOVERRIDE	驱动程序应使用 DirectDraw SDK 文档中介绍 (的 DDOVERLAYFX 结构的 dckSrcColorKey 成员) 作为源颜色键，而不是与目标图面关联的颜色键。
DDOVER_OVERRIDEBOBWEAVE	Bob/weave 决策不应被其他接口覆盖。 如果覆盖混音器设置此标志，则 DirectDraw 不允许内核模式驱动程序使用内核模式视频传输功能在 bob 和 weave 模式之间切换硬件。
DDOVER_REFRESHALL	驱动程序应忽略。
DDOVER_REFRESHDIRTYRECTS	驱动程序应忽略。
DDOVER_SHOW	驱动程序应显示覆盖层;也就是说，驱动程序应打开此覆盖。

overlayFX

指定 DirectDraw SDK 文档 (描述的 DDOVERLAYFX 结构) ，该结构描述驱动程序应使用其他效果来更新覆盖层。 仅当 在 dwFlags 成员中设置了DDOVER_DDFX、DDOVER_KEYDESTOVERRIDE或DDOVER_KEYSRCOVERRIDE之一时，驱动程序才应使用此结构。

ddRVal

指定驱动程序写入 DdUpdateOverlay 回调的返回值的位置。 返回代码DD_OK表示成功。 有关详细信息，请参阅 DirectDraw 的返回值。

UpdateOverlay

由 DirectDraw API 使用，驱动程序不应填充。

要求

标头	ddrawint.h (包括 Winddi.h)

另请参阅

DdUpdateOverlay