Edit

IDirectDrawClipper::Initialize method (ddraw.h)

  • Article

Initializes a DirectDrawClipper object that was created by using the CoCreateInstance COM function.

Syntax

HRESULT Initialize(
  [in] LPDIRECTDRAW unnamedParam1,
  [in] DWORD        unnamedParam2
);

Parameters

[in] unnamedParam1

A pointer to the DirectDraw object to associate with the DirectDrawClipper object. If this parameter is set to NULL, an independent DirectDrawClipper object is initialized; a call of this type is equivalent to using the DirectDrawCreateClipper function.

[in] unnamedParam2

Currently not used and must be set to 0.

Return value

If the method succeeds, the return value is DD_OK.

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

  • DDERR_ALREADYINITIALIZED
  • DDERR_INVALIDPARAMS

Remarks

The IDirectDrawClipper::Initialize method is provided for compliance with the Component Object Model (COM). If you used the DirectDrawCreateClipper function or the IDirectDraw7::CreateClipper method to create the DirectDrawClipper object, the IDirectDrawClipper::Initialize method returns DDERR_ALREADYINITIALIZED.

Requirements

Requirement Value
Target Platform Windows
Header ddraw.h
Library Ddraw.lib
DLL Ddraw.dll

See also

IDirectDrawClipper