IDirectDrawClipper::GetClipList 方法 (ddraw.h)

检索与 DirectDrawClipper 对象关联的剪辑列表的副本。 若要选择剪辑列表的子集,可以传递一个用于剪辑该剪辑列表的矩形。

语法

HRESULT GetClipList(
  [in]  LPRECT    unnamedParam1,
  [out] LPRGNDATA unnamedParam2,
  [out] LPDWORD   unnamedParam3
);

参数

[in] unnamedParam1

指向 GETClipList 用于剪辑剪辑列表的 RECT 结构的指针。 将此参数设置为 NULL 可检索整个剪辑列表。

[out] unnamedParam2

指向接收剪辑列表结果副本的 RGNDATA 结构的指针。 如果此参数为 NULL, 则 GetClipList 使用保存整个剪辑列表所需的字节数填充 lpdwSize 处的变量。

[out] unnamedParam3

指向变量的指针,该变量接收生成的剪辑列表的大小。 检索剪辑列表时,此参数是 lpClipList 中缓冲区的大小。 当 lpClipList 为 NULL 时, lpdwSize 处的变量将接收所需的缓冲区大小(以字节为单位)。

返回值

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

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

  • DDERR_GENERIC
  • DDERR_INVALIDCLIPLIST
  • DDERR_INVALIDOBJECT
  • DDERR_INVALIDPARAMS
  • DDERR_NOCLIPLIST
  • DDERR_REGIONTOOSMALL

要求

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

另请参阅

IDirectDrawClipper