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 |