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

Currently not used and must be set to 0.

Return Values

If the method succeeds, the return value is DD_OK.

If it fails, the method can return one of the following error values:

This method is provided for compliance with the Component Object Model (COM). If DirectDrawCreateClipper or the IDirectDraw7::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.

Requirements

  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, IDirectDraw7::CreateClipper