IDirectDrawClipper::Initialize

The IDirectDrawClipper::Initialize method initializes a DirectDrawClipper object that was created by using the CoCreateInstance COM function.

HRESULT Initialize(
  LPDIRECTDRAW lpDD,  
  DWORD dwFlags       
);

Parameters

lpDD
Address of the DirectDraw structure that represents the DirectDraw object. If this parameter is set to NULL, an independent DirectDrawClipper object is created (the equivalent of using the DirectDrawCreateClipper function).
dwFlags
This parameter is currently not used and must be set to 0.

Return Values

If the method succeeds, the return value is DD_OK.

If the method fails, the return value may be one of the following error values:

DDERR_ALREADYINITIALIZED
DDERR_INVALIDPARAMS

This method is provided for compliance with the Component Object Model (COM) protocol. If DirectDrawCreateClipper or the IDirectDraw4::CreateClipper method was used to create the DirectDrawClipper object, this method returns DDERR_ALREADYINITIALIZED.

Remarks

For more information about using IDirectDrawClipper::Initialize with CoCreateInstance, see Creating DirectDrawClipper Objects with CoCreateInstance.

QuickInfo

  Windows NT/2000: Requires Windows NT 4.0 SP3 or later.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in ddraw.h.
  Import Library: Use ddraw.lib.

See Also

IUnknown::AddRef, IUnknown::QueryInterface, IUnknown::Release, IDirectDraw4::CreateClipper