IDirectDraw7::CreateClipper 方法 (ddraw.h)

创建 DirectDrawClipper 对象。

语法

HRESULT CreateClipper(
  [in]  DWORD               unnamedParam1,
  [out] LPDIRECTDRAWCLIPPER *unnamedParam2,
  [in]  IUnknown            *unnamedParam3
);

参数

[in] unnamedParam1

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

[out] unnamedParam2

如果调用成功,则要设置为有效 IDirectDrawClipper 接口指针的变量的地址。

[in] unnamedParam3

允许将来与 COM 聚合功能兼容。 目前,如果此参数不为 NULL,此方法将返回错误。

返回值

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

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

  • DDERR_INVALIDOBJECT
  • DDERR_INVALIDPARAMS
  • DDERR_NOCOOPERATIVELEVELSET
  • DDERR_OUTOFMEMORY

注解

DirectDrawClipper 对象可以附加到 DirectDrawSurface,并在 IDirectDrawSurface7::BltIDirectDrawSurface7::BltBatchIDirectDrawSurface7::UpdateOverlay 操作期间使用。

若要创建非特定 DirectDraw 对象拥有的 DirectDrawClipper 对象,请使用 DirectDrawCreateClipper 函数。

要求

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

另请参阅

IDirectDraw7