通过

DirectDrawCreateClipper 函数 (ddraw.h)

  • 项目

创建不与 DirectDraw 对象关联的 DirectDrawClipper 对象的实例。

语法

HRESULT DirectDrawCreateClipper(
  [in]  DWORD               dwFlags,
  [out] LPDIRECTDRAWCLIPPER *lplpDDClipper,
  [in]  IUnknown            *pUnkOuter
);

参数

[in] dwFlags

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

[out] lplpDDClipper

要用新 DirectDrawClipper 对象的地址填充的指针的地址。

[in] pUnkOuter

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

返回值

如果函数成功，则返回值DD_OK。

如果失败，该函数可能会返回以下错误值之一：

  • DDERR_INVALIDPARAMS
  • DDERR_OUTOFMEMORY

注解

可以在创建任何 DirectDraw 对象之前调用 DirectDrawCreateClipper 。 由于这些 DirectDrawClipper 对象不归任何 DirectDraw 对象所有，因此在释放应用程序的对象时不会自动释放它们。 如果应用程序未显式释放 DirectDrawClipper 对象，则 DirectDraw 在应用程序终止时释放这些对象。

若要创建由特定 DirectDraw 对象拥有的 DirectDrawClipper 对象，请使用 IDirectDraw7：：CreateClipper 方法。

必须使用 LoadLibrary 显式链接到 Ddraw.dll 然后使用 GetProcAddress 访问 DirectDrawCreateClipper 函数。

要求

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