DDSURFACEDATA 结构 (dxmini.h)

DirectDraw 使用 DDSURFACEDATA 结构来表示内核模式微型端口驱动程序的图面。

语法

typedef struct _DDSURFACEDATA {
  DWORD     ddsCaps;
  DWORD     dwSurfaceOffset;
  ULONG_PTR fpLockPtr;
  DWORD     dwWidth;
  DWORD     dwHeight;
  LONG      lPitch;
  DWORD     dwOverlayFlags;
  DWORD     dwOverlayOffset;
  DWORD     dwOverlaySrcWidth;
  DWORD     dwOverlaySrcHeight;
  DWORD     dwOverlayDestWidth;
  DWORD     dwOverlayDestHeight;
  DWORD     dwVideoPortId;
  DWORD     dwFormatFlags;
  DWORD     dwFormatFourCC;
  DWORD     dwFormatBitCount;
  DWORD     dwRBitMask;
  DWORD     dwGBitMask;
  DWORD     dwBBitMask;
  ULONG     dwDriverReserved1;
  ULONG     dwDriverReserved2;
  ULONG     dwDriverReserved3;
  ULONG     dwDriverReserved4;
} DDSURFACEDATA, *LPDDSURFACEDATA;

成员

ddsCaps

指向包含用于描述图面的创建功能的 DDSCAPS 结构。

dwSurfaceOffset

指定从帧缓冲区开头到图面开头的字节偏移量。 此字段仅由微型端口驱动程序使用。

fpLockPtr

指向图面的开头。

dwWidth

指定图面宽度（以像素为单位）。

dwHeight

指定图面高度（以像素为单位）。

lPitch

指定图面间距（以字节为单位）。

dwOverlayFlags

指示一组标志，这些标志指定由 DdUpdateOverlay 设置的当前用户模式DDOVER_Xxx 标志。 此成员是以下任何值的按位 OR：

标志	含义
DDOVER_ADDDIRTYRECT	将脏矩形添加到模拟叠加图面。
DDOVER_ALPHADEST	使用像素格式的 alpha 信息或附加到目标图面的 alpha 通道图面作为此覆盖的 alpha 通道。
DDOVER_ALPHADESTCONSTOVERRIDE	使用 DDOVERLAYFX 结构的 dwAlphaDestConst 成员作为此覆盖的目标 alpha 通道。 DDOVERLAYFX 结构在 ddraw.h 中定义。
DDOVER_ALPHADESTNEG	随着 alpha 值增加 (0 不透明) ，目标图面变得更加透明。
DDOVER_ALPHADESTSURFACEOVERRIDE	使用 DirectDraw SDK 文档中定义的 DDOVERLAYFX (结构的 lpDDSAlphaDest 成员) 作为此覆盖层的 alpha 通道目标。
DDOVER_ALPHAEDGEBLEND	使用 DirectDraw SDK 文档中定义的 DDOVERLAYFX 结构的 dwAlphaEdgeBlend 成员 () 作为颜色键颜色边框的图像边缘的 alpha 通道。
DDOVER_ALPHASRC	使用像素格式的 alpha 信息或附加到源图面的 alpha 通道图面作为此覆盖的源 alpha 通道。
DDOVER_ALPHASRCCONSTOVERRIDE	使用 DirectDraw SDK 文档中定义的 DDOVERLAYFX 结构的 dwAlphaSrcConst 成员 () 作为此覆盖层的源 alpha 通道。
DDOVER_ALPHASRCNEG	当 alpha 值增加 (0 不透明) 时，源图面变得更加透明。
DDOVER_ALPHASRCSURFACEOVERRIDE	使用 DirectDraw SDK 文档中定义的 DDOVERLAYFX 结构的 lpDDSAlphaSrc 成员 () 作为此覆盖层的 alpha 通道源。
DDOVER_AUTOFLIP	每次发生硬件视频端口 VSYNC 时，自动翻转到翻转链中的下一个图面。
DDOVER_BOB	单独显示交错视频流的每个字段，而不会造成任何项目。
DDOVER_BOBHARDWARE	Bob 使用硬件而不是软件执行，或者正在模拟。
DDOVER_DDFX	使用覆盖 FX 标志定义特殊覆盖效果。
DDOVER_HIDE	关闭此覆盖。
DDOVER_INTERLEAVED	图面内存由交错字段组成。
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	打开此覆盖。

dwOverlayOffset

指定从帧缓冲区开头到覆盖层开头的字节偏移量。 此字段仅由微型端口驱动程序使用。

dwOverlaySrcWidth

指定覆盖源宽度（以像素为单位）。 此字段仅由微型端口驱动程序使用。

dwOverlaySrcHeight

指定覆盖源高度（以像素为单位）。 此字段仅由微型端口驱动程序使用。

dwOverlayDestWidth

指定覆盖目标宽度（以像素为单位）。 此字段仅由微型端口驱动程序使用。

dwOverlayDestHeight

指定覆盖目标高度（以像素为单位）。 此字段仅由微型端口驱动程序使用。

dwVideoPortId

如果此图面由 视频端口扩展 (VPE) 对象馈送，则此字段指示 VPE 对象的 ID，范围中的整数 (0 - (硬件视频端口的最大数目 -1 ) ) ;否则，此字段为 -1。

dwFormatFlags

指定一组像素格式控件标志。 此成员是以下任何值的按位 OR：

标志	含义
DDPF_ALPHA	像素格式描述仅限 alpha 的图面。
DDPF_ALPHAPIXELS	图面具有像素格式的 alpha 通道信息。
DDPF_ALPHAPREMULT	像素中的颜色分量由像素中的 alpha 值预乘。 如果设置了此标志，还必须设置DDPF_ALPHAPIXELS标志。 如果未设置此标志，但设置了DDPF_ALPHAPIXELS标志，则像素格式的颜色分量不会由 alpha 预乘。 在这种情况下，颜色分量必须在执行 alpha 混合操作时乘以 alpha 值。
DDPF_BUMPDUDV	像素格式的凹凸贴图 dUdV 数据有效。
DDPF_BUMPLUMINANCE	像素格式的亮度数据有效。 将亮度悬挂在凹凸贴图图面上时，使用此标志。 然后，像素亮度部分的位掩码由 DDPIXELFORMAT 结构的 dwBumpLuminanceBitCount 成员指示。
DDPF_COMPRESSED	图面将接受指定格式的像素数据，并在写入操作期间对其进行压缩。
DDPF_FOURCC	FOURCC 代码有效。
DDPF_LUMINANCE	像素格式的亮度数据有效。 此标志仅用于亮度或亮度加 alpha 表面;位深度随后由 DDPIXELFORMAT 结构的 dwLuminanceBitCount 成员指示。
DDPF_PALETTEINDEXED1	图面已编制 1 位颜色索引。
DDPF_PALETTEINDEXED2	图面已编制 2 位颜色索引。
DDPF_PALETTEINDEXED4	图面已编制 4 位颜色索引。
DDPF_PALETTEINDEXED8	图面已编制 8 位颜色索引。
DDPF_PALETTEINDEXEDTO8	表面是 1 位、2 位或 4 位颜色，索引到 8 位调色板。
DDPF_RGB	像素格式结构中的 RGB 数据有效。
DDPF_RGBTOYUV	图面将接受 RGB 数据，并在写入操作期间将其转换为 YUV 数据。 要写入的数据的格式将包含在像素格式结构中。 将设置DDPF_RGB标志。
DDPF_STENCILBUFFER	图面包含模具信息以及 Z 信息。
DDPF_YUV	像素格式结构中的 YUV 数据有效。
DDPF_ZBUFFER	像素格式描述仅限 z 缓冲区的图面。
DDPF_ZPIXELS	图面采用 RGBZ 格式。

dwFormatFourCC

指定 FOURCC 代码。

dwFormatBitCount

指定每像素 (4、8、16、24 或 32) 位数。

dwRBitMask

指定红色位掩码。

dwGBitMask

指定绿色位掩码。

dwBBitMask

指定蓝色位掩码。

dwDriverReserved1

为 HAL/微型端口保留

dwDriverReserved2

为 HAL/微型端口保留

dwDriverReserved3

为 HAL/微型端口保留

dwDriverReserved4

保留供微型端口驱动程序使用。

要求

标头	dxmini.h (包括 Dxmini.h)

请参阅

DDPIXELFORMAT

DDSCAPS

DdUpdateOverlay