IDirectDrawClipper::SetClipList 方法 (ddraw.h)
设置或删除 IDirectDrawSurface7::Blt、 IDirectDrawSurface7::BltBatch 和 IDirectDrawSurface7::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 |