DD_SYNCSURFACEDATA 结构 (ddrawint.h)

DD_SYNCSURFACEDATA 结构包含图面信息。

语法

typedef struct _DD_SYNCSURFACEDATA {
  PDD_DIRECTDRAW_LOCAL lpDD;
  PDD_SURFACE_LOCAL    lpDDSurface;
  DWORD                dwSurfaceOffset;
  ULONG_PTR            fpLockPtr;
  LONG                 lPitch;
  DWORD                dwOverlayOffset;
  ULONG                dwDriverReserved1;
  ULONG                dwDriverReserved2;
  ULONG                dwDriverReserved3;
  ULONG                dwDriverReserved4;
  HRESULT              ddRVal;
} *PDD_SYNCSURFACEDATA, DD_SYNCSURFACEDATA;

成员

lpDD

指向仅与当前 Microsoft DirectDraw 进程相关的 DD_DIRECTDRAW_LOCAL 结构。

lpDDSurface

指向描述要同步的图面 的DD_SURFACE_LOCAL 结构。

dwSurfaceOffset

包含从帧缓冲区开头到图面开头的字节偏移量。 此值仅由视频微型端口驱动程序使用。 此成员必须包含由驱动程序填充的数据。

fpLockPtr

包含要由 DdLock 调用返回的用于访问图面的指针值。 此值由内核模式客户端使用。 此成员可由驱动程序修改,但不需要修改。

lPitch

包含 DdLock 调用期间传递给客户端的音调(以字节为单位)。 此成员可由驱动程序修改,但不需要修改。

dwOverlayOffset

包含从帧缓冲区开头到覆盖层开头的字节偏移量。 此值仅由视频微型端口驱动程序使用,如果涉及裁剪或覆盖原点不是图面左上角,则此值可能与 dwSurfaceOffset 成员不同。 此成员必须包含由驱动程序填充的数据。

dwDriverReserved1

保留供显示驱动程序使用。

dwDriverReserved2

保留供显示驱动程序使用。

dwDriverReserved3

保留供显示驱动程序使用。

dwDriverReserved4

保留供显示驱动程序使用。 仅限 Windows 2000 及更高版本。

ddRVal

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

要求

要求
Header ddrawint.h (包括 Winddi.h)

另请参阅

DdLock

DdSyncSurfaceData