IDirectDrawClipper::SetClipList 方法 (ddraw.h)

设置或删除 IDirectDrawSurface7::BltIDirectDrawSurface7::BltBatchIDirectDrawSurface7::UpdateOverlay 方法在父 DirectDrawClipper 对象所附加到的图面上使用的剪辑列表。

语法

HRESULT SetClipList(
  [in] LPRGNDATA unnamedParam1,
  [in] DWORD     unnamedParam2
);

参数

[in] unnamedParam1

指向要设置或为 NULL 的剪辑列表的有效 RGNDATA 结构的指针。 如果存在与 DirectDrawClipper 对象关联的现有剪辑列表,并且此值为 NULL,则删除剪辑列表。

[in] unnamedParam2

当前未使用,并且必须设置为 0。

返回值

如果方法成功,则返回值DD_OK。

如果失败,方法可能会返回以下错误值之一:

  • DDERR_CLIPPERISUSINGHWND
  • DDERR_INVALIDCLIPLIST
  • DDERR_INVALIDOBJECT
  • DDERR_INVALIDPARAMS
  • DDERR_OUTOFMEMORY

备注

如果窗口句柄已与 DirectDrawClipper 对象关联,则无法设置剪辑列表。

IDirectDrawSurface7::BltFast 方法无法剪辑。 如果在具有附加剪辑器的图面上调用 IDirectDrawSurface7::BltFast ,它将返回DDERR_UNSUPPORTED。

要求

   
目标平台 Windows
标头 ddraw.h
Library Ddraw.lib
DLL Ddraw.dll

请参阅

IDirectDrawClipper