共用方式為


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
程式庫 Ddraw.lib
Dll Ddraw.dll